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.
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ć.

PlaceSearchRequest interfejs

google.maps.places.PlaceSearchRequestinterfejs

Zapytanie dotyczące wyszukiwania miejsca, które ma zostać wysłane do PlacesService.
bounds optional
Granice, w których mają być wyszukiwane miejsca. Jeśli ustawiona jest wartość bounds, zarówno location, jak i radius są ignorowane.
keyword optional
Typ:  string optional
Termin, który ma być dopasowany do wszystkich dostępnych pól, w tym m.in. nazwy, typu i adresu, a także opinii klientów i innych treści pochodzących od osób trzecich.
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.
location optional
Typ:  LatLng|LatLngLiteral optional
Lokalizacja, w pobliżu której mają być wyszukiwane miejsca.
maxPriceLevel optional
Typ:  number optional
Ogranicza wyniki do miejsc o określonym poziomie cenowym lub niższym. Prawidłowe wartości to od 0 (najbardziej przystępna cena) do 4 (najwyższa cena) włącznie. Jeśli została określona, musi być równa lub większa niż minPrice .
minPriceLevel optional
Typ:  number optional
Ogranicza wyniki tylko do miejsc o określonym poziomie cen lub wyższym. Prawidłowe wartości to od 0 (najbardziej przystępna cena) do 4 (najwyższa cena) włącznie. Jeśli wartość została określona, musi być równa lub mniejsza niż maxPrice.
name optional
Typ:  string optional
Odpowiednik: keyword. Wartości w tym polu są łączone z wartościami w polu keyword i przekazywane w ramach tego samego ciągu wyszukiwania.
openNow optional
Typ:  boolean optional
Ogranicza wyniki tylko do miejsc, które są obecnie otwarte.
radius optional
Typ:  number optional
Odległość od podanej lokalizacji, w której mają być wyszukiwane miejsca (w metrach). Maksymalna dozwolona wartość to 50 000.
rankBy optional
Typ:  RankBy optional
Domyślnie: RankBy.PROMINENCE
Określa metodę rankingu, która ma być używana podczas zwracania wyników. Pamiętaj, że gdy parametr rankBy ma wartość DISTANCE, musisz określić parametr location, ale nie możesz określić parametrów radius ani bounds.
type optional
Typ:  string optional
Wyszukuje miejsca danego typu. Typ jest tłumaczony na język lokalny lokalizacji docelowej żądania i używany jako ciąg zapytania. Jeśli podano też zapytanie, jest ono łączone z ciągiem znaków zlokalizowanego typu. Wyniki innego typu są pomijane w odpowiedzi. Użyj tego pola, aby przeprowadzić wyszukiwanie kategorii niezależne od języka i regionu. Prawidłowe typy znajdziesz tutaj.

TextSearchRequest interfejs

google.maps.places.TextSearchRequestinterfejs

Prośba o wyszukiwanie tekstowe, która ma zostać wysłana do PlacesService.
bounds optional
Typ:  LatLngBounds|