Places Autocomplete Service

Klasa AutocompleteService

Klasa google.maps.places.AutocompleteService

Zawiera metody pobierania prognoz autouzupełniania.

Zadzwoń pod numer const {AutocompleteService} = await google.maps.importLibrary("places"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

Zespół
AutocompleteService	AutocompleteService() Parametry: brak Tworzy nowe wystąpienie obiektu AutocompleteService.

Metody
getPlacePredictions	getPlacePredictions(request[, callback]) Parametry:  request:  AutocompletionRequest żądanie autouzupełniania. callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional wywołanie zwrotne akceptujące tablicę obiektów autouzupełniania oraz wartość „PlaceServiceStatus” jako argument. Wartość zwrotu:  Promise<AutocompleteResponse> Pobiera prognozy autouzupełniania miejsc na podstawie podanego żądania autouzupełniania.
getQueryPredictions	getQueryPredictions(request, callback) Parametry:  request:  QueryAutocompletionRequest żądanie autouzupełniania zapytań. callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void wywołanie zwrotne akceptujące tablicę obiektów QueryAutofillPrediction i wartość PlacesServiceStatus jako argument. Zwracana wartość: brak Pobiera prognozy autouzupełniania zapytań na podstawie podanego żądania autouzupełniania zapytań.

Interfejs autouzupełniania interfejs

google.maps.places.AutocompletionRequest interfejs

Żądanie autouzupełniania, które ma zostać wysłane na adres AutocompleteService.getPlacePredictions.

Właściwości
input	Typ:  string Użytkownik wpisał tekst wejściowy.
bounds optional	Wycofane: wersja bounds została wycofana w maju 2023 roku. Zamiast nich użyj zasad AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  LatLngBounds|LatLngBoundsLiteral optional Ograniczenia na potrzeby promowania wyników. Prognozy będą stronnicze dla bounds (ale nie tylko). Zarówno zasada location, jak i radius są ignorowane, jeśli ustawiono wartość bounds.
componentRestrictions optional	Typ:  ComponentRestrictions optional Ograniczenia komponentu. Ograniczenia komponentów służą do ograniczania prognoz tylko do tych należących do komponentu nadrzędnego. Na przykład kraj.
language optional	Typ:  string optional W miarę możliwości określ język języka, w którym mają być zwracane wyniki. Wyniki w wybranym języku mogą mieć wyższą pozycję w rankingu, ale sugestie nie są ograniczane do tego języka. Zobacz listę obsługiwanych języków.
location optional	Wycofane: wersja location została wycofana w maju 2023 roku. Zamiast nich użyj zasad AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  LatLng optional Lokalizacja na potrzeby promowania wyników. Prognozy będą odchylane o podane wartości location i radius. Można też użyć metody bounds.
locationBias optional	Typ:  LocationBias optional Miękka granica lub wskazówka, której należy użyć podczas wyszukiwania miejsc.
locationRestriction optional	Typ:  LocationRestriction optional Ograniczony, aby ograniczyć wyniki wyszukiwania.
offset optional	Typ:  number optional Pozycja znaku w wyszukiwanym haśle, w którym usługa używa tekstu do prognozowania (pozycja kursora w polu do wprowadzania danych).
origin optional	Typ:  LatLng|LatLngLiteral optional Lokalizacja, w której obliczana jest wartość AutocompletePrediction.distance_meters.
radius optional	Wycofane: wersja radius została wycofana w maju 2023 roku. Zamiast nich użyj zasad AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  number optional Promień obszaru używanego do promowania wyników prognozowania. Pole radius jest określane w metrach i zawsze musi mu towarzyszyć właściwość location. Można też użyć metody bounds.
region optional	Typ:  string optional Kod regionu używany do formatowania wyników i filtrowania wyników. Nie ogranicza ono sugestii do tego kraju. Kod regionu może mieć dwuznakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest taka sama jak kody ISO 3166-1, ale istnieją pewne wyjątki. Na przykład krajowa domena ccTLD to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Wielka Brytania i Irlandia Północna”).
sessionToken optional	Typ:  AutocompleteSessionToken optional Unikalne odwołanie używane do łączenia poszczególnych żądań w sesje.
types optional	Typ:  Array<string> optional Typy prognoz, które mają zostać zwrócone. Informacje o obsługiwanych typach znajdziesz w przewodniku dla programistów. Jeśli nie podasz żadnego typu, zostaną zwrócone wszystkie typy.

Interfejs Autouzupełnienia

google.maps.places.AutocompleteResponse interfejs

Odpowiedź autouzupełniania zwrócona przez wywołanie AutocompleteService.getPlacePredictions, która zawiera listę AutocompletePrediction.

Właściwości
predictions	Typ:  Array<AutocompletePrediction> Lista AutocompletePrediction.

Interfejs QueryAutocompleteRequest

google.maps.places.QueryAutocompletionRequest interfejs

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

Właściwości
input	Typ:  string Użytkownik wpisał tekst wejściowy.
bounds optional	Typ:  LatLngBounds|LatLngBoundsLiteral optional Ograniczenia na potrzeby promowania wyników. Prognozy będą stronnicze dla bounds (ale nie tylko). Zarówno zasada location, jak i radius są ignorowane, jeśli ustawiono wartość bounds.
location optional	Typ:  LatLng optional Lokalizacja na potrzeby promowania wyników. Prognozy będą odchylane o podane wartości location i radius. Można też użyć metody bounds.
offset optional	Typ:  number optional Pozycja znaku w wyszukiwanym haśle, w którym 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 wyników prognozowania. Pole radius jest określane w metrach i zawsze musi mu towarzyszyć właściwość location. Można też użyć metody bounds.

Klasa AutocompleteSessionToken

Klasa google.maps.places.AutocompleteSessionToken

Reprezentuje token sesji używany do śledzenia sesji autouzupełniania, który może być serią wywołań AutocompleteService.getPlacePredictions, po których następuje pojedyncze wywołanie PlacesService.getDetails.

Zadzwoń pod numer const {AutocompleteSessionToken} = await google.maps.importLibrary("places"), aby uzyskać dostęp. Zobacz biblioteki w interfejsie Maps JavaScript API.

Zespół
AutocompleteSessionToken	AutocompleteSessionToken() Parametry: brak Tworzy nowe wystąpienie AutocompleteSessionToken.

Interfejs ComponentRestrictions

google.maps.places.ComponentRestrictions interfejs

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

Właściwości
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ć pojedynczy ciąg znaków lub tablicę z maksymalnie 5 ciągami kodu kraju.

Interfejs autouzupełniania

google.maps.places.AutocompletePrediction interfejs

Reprezentuje pojedynczą prognozę autouzupełniania.

Właściwości
description	Typ:  string To jest niesformatowana wersja zapytania zaproponowana przez usługę Miejsca.
matched_substrings	Typ:  Array<PredictionSubstring> Zestaw podłańcuchów w opisie miejsca, który pasuje do elementów w danych wejściowych użytkownika. Można ich używać do wyróżniania tych podłańcuchów. Każdy podłańcuch jest określany przez przesunięcie i długość wyrażoną w kodach Unicode.
place_id	Typ:  string Identyfikator miejsca, który umożliwia pobranie szczegółowych informacji o tym miejscu za pomocą usługi szczegółów miejsca (zobacz PlacesService.getDetails).
structured_formatting	Typ:  StructuredFormatting Uporządkowane informacje o opisie miejsca podzielone na tekst główny i dodatkowy, w tym tablicę z pasującymi podłańcuchami z danych autouzupełniania, które są wskazywane przez przesunięcie i długość w postaci znaków Unicode.
terms	Typ:  Array<PredictionTerm> Informacje dotyczące poszczególnych wyrażeń w opisie powyżej (od najbardziej do najmniej szczegółowych). Na przykład „Taco Bell”, „Willitis” i „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) w metrach.

Interfejs autouzupełniania zapytań prognozowania

google.maps.places.QueryAutocompletePrediction interfejs

Reprezentuje pojedynczą prognozę autouzupełniania zapytań.

Właściwości
description	Typ:  string To jest niesformatowana wersja zapytania zaproponowana przez usługę Miejsca.
matched_substrings	Typ:  Array<PredictionSubstring> Zestaw podłańcuchów w opisie miejsca, który pasuje do elementów w danych wejściowych użytkownika. Można ich używać do wyróżniania tych podłańcuchów. Każdy podłańcuch jest określany przez przesunięcie i długość wyrażoną w kodach Unicode.
terms	Typ:  Array<PredictionTerm> Informacje na temat poszczególnych terminów powyżej. Pierwszeństwo w kategoriach (np. „restauracja”). Warunki adresu są wyświetlane w kolejności od najbardziej do najmniej szczegółowych. np. „Kraków” i „PL”.
place_id optional	Typ:  string optional Dostępna tylko wtedy, gdy prognoza jest miejscem. Identyfikator miejsca, który umożliwia pobranie szczegółowych informacji o tym miejscu za pomocą usługi szczegółów miejsca (zobacz PlacesService.getDetails).

Interfejs PredictionTerm

google.maps.places.PredictionTerm interfejs

Reprezentuje termin prognostyczny.

Właściwości
offset	Typ:  number Przesunięcie od początku tego hasła 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 prognozy.

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

Interfejs StructuredFormat

google.maps.places.StructuredFormatting interfejs

Zawiera uporządkowane informacje na temat opisu miejsca podzielone na tekst główny i dodatkowy, w tym tablicę z pasującymi podłańcuchami z danych autouzupełniania, które są wskazywane przez przesunięcie i długość wyrażoną w znakach Unicode.

Właściwości
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	Typ:  Array<PredictionSubstring> Zestaw podłańcuchów w tekście głównym, które pasują do elementów w danych wejściowych użytkownika, odpowiednich do wyróżniania tych podłańcuchów. Każdy podłańcuch jest określany przez przesunięcie i długość wyrażoną w kodach Unicode.
secondary_text	Typ:  string To jest druga część tekstu niesformatowanego opisu miejsca sugerowanego przez usługę Miejsca. Zwykle jest to lokalizacja miejsca.