Places Autocomplete Service

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Klasa AutocompleteService

google.maps.places.AutocompleteService klasa

Zawiera metody związane z pobieraniem podpowiedzi autouzupełniania.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

Jeśli używasz aplikacji v=beta, możesz zadzwonić pod numer const {AutocompleteService} = await google.map.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

AutocompleteService
AutocompleteService()
Parametry: brak
Tworzy nowe wystąpienie AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Parametry:
Zwrócona wartość: Promise<AutocompleteResponse>
Pobiera podpowiedzi autouzupełniania miejsc na podstawie podanego żądania autouzupełniania.
getQueryPredictions
getQueryPredictions(request, callback)
Parametry:
Zwróć wartość: brak
Pobiera prognozy autouzupełniania zapytań na podstawie podanego żądania autouzupełniania zapytań.

Interfejs Autouzupełnienia

google.maps.places.AutocompletionRequest interfejs

Żądanie autouzupełniania zostanie wysłane na adres AutocompleteService.getPlacePredictions.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

input
Typ: string
Użytkownik wpisał ciąg znaków.
bounds optional
Ograniczenia do promowania ze względu na prognozę. Prognozy będą obiektywne, ale nie będą ograniczać się do podanego argumentu bounds. Zarówno location, jak i radius będą ignorowane, jeśli ustawisz bounds.
componentRestrictions optional
Typ: ComponentRestrictions optional
Ograniczenia komponentu. Ograniczenia komponentów służą do ograniczania prognoz tylko do tych komponentów nadrzędnych. Na przykład kraj.
language optional
Typ: string optional
Identyfikator języka, w którym jest zwracany wyniki (jeśli to możliwe). Wyniki w wybranym języku mogą mieć wyższą pozycję w rankingu, ale sugestie nie są ograniczone do tego języka. Zobacz listę obsługiwanych języków.
location optional
Typ: LatLng optional
Lokalizacja do promowania ze względu na prognozę. Prognozy będą promowane z uwzględnieniem podanych wartości location i radius. Możesz też użyć polecenia bounds.
offset optional
Typ: number optional
Pozycja znaku w wartości wejściowej, w której usługa używa tekstu do prognozowania (pozycja kursora w polu do wprowadzania danych).
origin optional
Typ: LatLng|LatLngLiteral optional
Lokalizacja, w której jest obliczana wartość AutocompletePrediction.distance_meters.
radius optional
Typ: number optional
Promień obszaru używanego do promowania prognoz. Element radius jest określony w metrach i musi mu towarzyszyć właściwość location. Możesz też użyć polecenia bounds.
region optional
Typ: string optional
Kod regionu używany do formatowania wyników i do filtrowania wyników. Nie ogranicza to sugestii do tego kraju. Kod regionu może mieć wartość 2-znakową ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład ccTLD Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Wielka Brytania i Irlandia Północna”).
sessionToken optional
Unikalne odwołanie pozwalające grupować poszczególne żądania w sesje.
types optional
Typ: Array<string> optional
Typy prognoz, które mają zostać zwrócone. Obsługiwane typy znajdziesz w przewodniku dla programistów. Jeśli nie podasz żadnych typów, zostaną zwrócone wszystkie typy.

Interfejs autouzupełniania

google.maps.places.AutocompleteResponse interfejs

Odpowiedź autouzupełniania zwrócona przez wywołanie do AutocompleteService.getPlacePredictions zawierająca listę AutocompletePrediction s.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

predictions
Lista zasobów typu AutocompletePrediction.

Interfejs QueryAutocompleteRequest

google.maps.places.QueryAutocompletionRequest interfejs

Żądanie autouzupełniania zapytań wysyłane do QueryAutocompleteService.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

input
Typ: string
Użytkownik wpisał ciąg znaków.
bounds optional
Ograniczenia do promowania ze względu na prognozę. Prognozy będą obiektywne, ale nie będą ograniczać się do podanego argumentu bounds. Zarówno location, jak i radius będą ignorowane, jeśli ustawisz bounds.
location optional
Typ: LatLng optional
Lokalizacja do promowania ze względu na prognozę. Prognozy będą promowane z uwzględnieniem podanych wartości location i radius. Możesz też użyć polecenia bounds.
offset optional
Typ: number optional
Pozycja znaku w wartości wejściowej, w której usługa używa tekstu do prognozowania (pozycja kursora w polu do wprowadzania danych).
radius optional
Typ: number optional
Promień obszaru używanego do promowania prognoz. Element radius jest określony w metrach i musi mu towarzyszyć właściwość location. Możesz też użyć polecenia bounds.

AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken klasa

Reprezentuje token sesji używany do śledzenia sesji autouzupełniania, który może składać się z AutocompleteService.getPlacePredictions wywołań i pojedynczych wywołań PlacesService.getDetails.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

Jeśli używasz aplikacji v=beta, możesz zadzwonić pod numer const {AutocompleteSessionToken} = await google.map.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

AutocompleteSessionToken
AutocompleteSessionToken()
Parametry: brak
Tworzy nową instancję AutocompleteSessionToken.

Interfejs ComponentRestrictions

google.maps.places.ComponentRestrictions interfejs

Określa ograniczenia komponentu, których można używać z usługą autouzupełniania.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

country optional
Typ: string|Array<string> optional
Ogranicza podpowiedzi do określonego kraju (kod kraju w formacie ISO 3166-1 alfa-2 bez rozróżniania wielkości liter). na przykład 'us', 'br' lub 'au'. Możesz podać jeden ciąg znaków lub tablicę z maksymalnie 5 ciągami kodów kraju.

Interfejs autouzupełniania podpowiedzi

google.maps.places.AutocompletePrediction interfejs

Reprezentuje jedną prognozę autouzupełniania.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

description
Typ: string
To jest niesformatowana wersja zapytania zaproponowana przez usługę Miejsca.
matched_substrings
Zestaw podłańcuchów w opisie miejsca, który pasuje do elementów w danych wejściowych użytkownika. Służy do wyróżniania tych podłańcuchów. Każdy podłańcuch jest identyfikowany przez przesunięcie i długość, wyrażone w znakach Unicode.
place_id
Typ: string
Identyfikator miejsca, którego można użyć do pobrania szczegółowych informacji o miejscu za pomocą usługi szczegółów miejsca (patrz PlacesService.getDetails).
structured_formatting
Uporządkowane informacje o danym miejscu podzielone na tekst główny i dodatkowy, w tym na tablicę z pasującymi podłańcuchami z danych autouzupełniania, identyfikowane przez przesunięcie i długość, wyrażone w znakach Unicode.
terms
Informacje o pojedynczych hasłach w opisie powyżej, od najbardziej do najmniej szczegółowych Na przykład „Taco Bell”, „Willitis” lub „CA”.
types
Typ: Array<string>
Tablica typów, do których należy prognoza, na przykład 'establishment' lub 'geocode'.
distance_meters optional
Typ: number optional
Odległość od miejsca: AutocompletionRequest.origin.

Interfejs autouzupełniania zapytań

google.maps.places.QueryAutocompletePrediction interfejs

Reprezentuje jedną prognozę autouzupełniania zapytań.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

description
Typ: string
To jest niesformatowana wersja zapytania zaproponowana przez usługę Miejsca.
matched_substrings
Zestaw podłańcuchów w opisie miejsca, który pasuje do elementów w danych wejściowych użytkownika. Służy do wyróżniania tych podłańcuchów. Każdy podłańcuch jest identyfikowany przez przesunięcie i długość, wyrażone w znakach Unicode.
terms
Informacje o poszczególnych warunkach w powyższym opisie. Pierwszeństwo ma kategoria kategoria (np. „restauracja”). Hasła adresowe są wyświetlane w kolejności od najbardziej do najmniej szczegółowych. Na przykład „San Francisco” i „CA”.
place_id optional
Typ: string optional
Dostępne tylko wtedy, gdy prognoza jest miejscem. Identyfikator miejsca, którego można użyć do pobrania szczegółowych informacji o miejscu za pomocą usługi szczegółów miejsca (patrz PlacesService.getDetails).

Interfejs PredictionTerm

google.maps.places.PredictionTerm interfejs

Reprezentuje hasło prognozy.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

offset
Typ: number
Odsunięcie od początku danego terminu w opisie miejsca (w znakach Unicode).
value
Typ: string
Wartość tego hasła, na przykład „Taco Bell”.

Interfejs PredictionSubstring

google.maps.places.PredictionSubstring interfejs

Reprezentuje podłańcuch prognoz.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

length
Typ: number
Długość podłańcucha.
offset
Typ: number
Odsunięcie do początku podłańcucha w ciągu tekstu reklamy.

Interfejs StructuredFormatowanie

google.maps.places.StructuredFormatting interfejs

Zawiera uporządkowane informacje na temat opisu miejsca, podzielone na tekst główny i tekst dodatkowy, w tym tablicę pasujących podłańcuchów z danych autouzupełniania, identyfikowane przez przesunięcie i długość, wyrażone w znakach Unicode.

Wczytaj za pomocą parametru adresu URL &libraries=places. Zobacz Biblioteki w interfejsie Maps JavaScript API.

main_text
Typ: string
To główna część tekstu niesformatowanego opisu miejsca sugerowanego przez usługę Miejsca. Zwykle jest to nazwa miejsca.
main_text_matched_substrings
Zestaw podłańcuchów w głównym tekście, które pasują do elementów w danych wejściowych użytkownika, co umożliwia ich wykorzystanie do podświetlenia tych podłańcuchów. Każdy podłańcuch jest identyfikowany przez przesunięcie i długość, wyrażone w znakach Unicode.
secondary_text
Typ: string
To jest druga część tekstu niesformatowanego opisu miejsca sugerowanego przez usługę Miejsca. Zwykle jest to lokalizacja miejsca.