Places Service

PlacesService class

google.maps.places.PlacesService zajęcia

Zawiera metody związane z wyszukiwaniem miejsc i pobieraniem szczegółowych informacji o nich.

Dostęp przez połączenie pod numer const {PlacesService} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
PlacesService
PlacesService(attrContainer)
Parametry: 
Tworzy nową instancję PlacesService, która renderuje atrybucje w określonym kontenerze.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parametry: 
Zwracana wartość: brak
Pobiera listę miejsc na podstawie numeru telefonu. W większości przypadków na liście wyników powinien znajdować się tylko 1 element, ale jeśli żądanie jest niejednoznaczne, może zostać zwróconych więcej wyników. Wartości PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnej wartości PlaceResult. Aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, wywołując PlacesService.getDetails i przekazując PlaceResult.place_id dla wybranego miejsca.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Parametry: 
Zwracana wartość: brak
Pobiera listę miejsc na podstawie ciągu zapytania. W większości przypadków na liście wyników powinien znajdować się tylko 1 element, ale jeśli żądanie jest niejednoznaczne, może zostać zwróconych więcej wyników. Wartości PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnej wartości PlaceResult. Aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, wywołując PlacesService.getDetails i przekazując PlaceResult.place_id dla wybranego miejsca.
getDetails
getDetails(request, callback)
Parametry: 
Zwracana wartość: brak
Pobiera szczegóły miejsca określonego przez podany identyfikator placeId.
nearbySearch
nearbySearch(request, callback)
Parametry: 
Zwracana wartość: brak
Pobiera listę miejsc w pobliżu określonej lokalizacji na podstawie słowa kluczowego lub typu. Lokalizację należy zawsze określać, przekazując parametr LatLngBounds lub parametry location i radius. Obiekty PlaceResult przekazywane do wywołania zwrotnego są podzbiorami pełnego obiektu PlaceResult. Aplikacja może uzyskać bardziej szczegółowe PlaceResult dla każdego miejsca, wysyłając żądanie szczegółów miejsca z PlaceResult.place_id wybranego miejsca. Obiektu PlaceSearchPagination można użyć do pobrania dodatkowych stron wyników (wartość null, jeśli jest to ostatnia strona wyników lub jeśli jest tylko jedna strona wyników).
textSearch
textSearch(request, callback)
Parametry: 
Zwracana wartość: brak
Pobiera listę miejsc na podstawie ciągu zapytania (np. „pizza w Warszawie” lub „sklepy obuwnicze w pobliżu Krakowa”). Parametry lokalizacji są opcjonalne. Jeśli lokalizacja jest określona, wyniki są tylko ukierunkowane na pobliskie wyniki, a nie ograniczone do miejsc w danym obszarze. Użyj textSearch, gdy chcesz wyszukać miejsca za pomocą dowolnego ciągu znaków i w przypadkach, w których nie chcesz ograniczać wyników wyszukiwania do określonej lokalizacji. Obiektu PlaceSearchPagination można użyć do pobrania dodatkowych stron wyników (wartość null, jeśli jest to ostatnia strona wyników lub jeśli jest tylko jedna strona wyników).

Interfejs PlaceDetailsRequest

google.maps.places.PlaceDetailsRequestinterfejs

Zapytanie o szczegóły miejsca, które ma zostać wysłane do PlacesService.
placeId
Typ:  string
Identyfikator miejsca, którego szczegóły są wymagane.
fields optional
Typ:  Array<string> optional
Pola, które mają być uwzględnione w odpowiedzi ze szczegółami, za które zostanie naliczona opłata. Jeśli nie określisz żadnych pól lub przekażesz wartość ['ALL'], zwracane będą wszystkie dostępne pola, za które zostanie naliczona opłata (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult. Pola zagnieżdżone można określać za pomocą ścieżek z kropkami (np. "geometry.location").
language optional
Typ:  string optional
Identyfikator języka, w którym mają być zwracane szczegóły. Zobacz listę obsługiwanych języków.
region optional
Typ:  string optional
Kod regionu użytkownika. Może to mieć wpływ na to, które zdjęcia zostaną zwrócone, a także na inne aspekty. Kod regionu akceptuje 2-znakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”).
sessionToken optional
Typ:  AutocompleteSessionToken optional
Unikalny identyfikator używany do łączenia prośby o szczegóły z sesją autouzupełniania.

FindPlaceFromPhoneNumberRequest interfejs

google.maps.places.FindPlaceFromPhoneNumberRequestinterfejs

Prośba o wyszukanie miejsca na podstawie tekstu, która ma zostać wysłana do PlacesService.findPlaceFromPhoneNumber.
fields
Typ:  Array<string>
Pola, które mają być uwzględnione w odpowiedzi, za które zostanie naliczona opłata. Jeśli przekażesz wartość ['ALL'], zwracane będą wszystkie dostępne pola, za które będziesz płacić (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult. Pola zagnieżdżone można określać za pomocą ścieżek z kropkami (np. "geometry.location").
phoneNumber
Typ:  string
Numer telefonu miejsca, które chcesz wyszukać. Musi być w E.164.
language optional
Typ:  string optional
Identyfikator języka, w którym w miarę możliwości mają być zwracane nazwy i adresy. Zobacz listę obsługiwanych języków.
locationBias optional
Typ:  LocationBias optional
Odchylenie używane podczas wyszukiwania miejsca. Wynik będzie bardziej zbliżony do podanego LocationBias, ale nie będzie się do niego ograniczać.

FindPlaceFromQueryRequest interfejs

google.maps.places.FindPlaceFromQueryRequestinterfejs

Prośba o wyszukanie miejsca na podstawie tekstu, która ma zostać wysłana do PlacesService.findPlaceFromQuery.
fields
Typ:  Array<string>
Pola, które mają być uwzględnione w odpowiedzi, za które zostanie naliczona opłata. Jeśli przekażesz wartość ['ALL'], zwracane będą wszystkie dostępne pola, za które będziesz płacić (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult. Pola zagnieżdżone można określać za pomocą ścieżek z kropkami (np. "geometry.location").
query
Typ:  string
Zapytanie w żądaniu. Na przykład nazwa lub adres miejsca.