Places Autocomplete Service

AutocompleteService class

google.maps.places.AutocompleteService class

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

Dostęp przez połączenie telefoniczne const {AutocompleteService} = await google.maps.importLibrary("places"). Zobacz Biblioteki w Maps JavaScript API.

Zespół
AutocompleteService	AutocompleteService() Parametry: brak Tworzy nową instancję AutocompleteService.

Metody
getPlacePredictions	getPlacePredictions(request[, callback]) Parametry:  request:  AutocompletionRequest prośba o autouzupełnianie. callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional funkcja wywoływana z argumentem tablica obiektów AutocompletePrediction i wartością PlacesServiceStatus. Wartość zwracana:  Promise<AutocompleteResponse> Pobiera przewidywane wyniki autouzupełniania miejsca na podstawie przesłanego zapytania o autouzupełnianie.
getQueryPredictions	getQueryPredictions(request, callback) Parametry:  request:  QueryAutocompletionRequest prośba o automatyczne uzupełnianie zapytań. callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void funkcja wywoływana z argumentem tablica obiektów QueryAutocompletePrediction i wartością PlacesServiceStatus. Zwracana wartość:  brak Pobiera prognozy autouzupełniania zapytań na podstawie przesłanego zapytania o autouzupełnianie zapytań.

Interfejs AutocompletionRequest

google.maps.places.AutocompletionRequestinterfejs

Prośba o autouzupełnianie została wysłana na adres AutocompleteService.getPlacePredictions.

Właściwości
input	Typ:  string Wprowadzony przez użytkownika ciąg znaków.
bounds optional	Wycofane: bounds zostało wycofane w maju 2023 r. Zamiast niej użyj zasad AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  LatLngBounds|LatLngBoundsLiteral optional Przedziały błędów prognozy. Prognozy będą uwzględniać dany bounds, ale nie będą się do niego ograniczać. Jeśli ustawiona jest wartość bounds, zarówno location, jak i radius zostaną zignorowane.
componentRestrictions optional	Typ:  ComponentRestrictions optional Ograniczenia komponentu. Ograniczenia komponentów służą do ograniczania prognoz do tych, które znajdują się w komponencie nadrzędnym. Na przykład kraj.
language optional	Typ:  string optional Identyfikator języka, w którym mają być zwracane wyniki (jeśli to możliwe). Wyniki w wybranym języku mogą być lepiej oceniane, ale sugestie nie są ograniczone do tego języka. Zobacz listę obsługiwanych języków.
location optional	Wycofane: location zostało wycofane w maju 2023 r. Zamiast niej użyj zasad AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  LatLng optional Lokalizacja służąca do ukierunkowania prognozy. Przewidywania będą uwzględniać dane z określonych location i radius. Możesz też użyć właściwości bounds.
locationBias optional	Typ:  LocationBias optional Miękka granica lub wskazówka do wykorzystania podczas wyszukiwania miejsc.
locationRestriction optional	Typ:  LocationRestriction optional ogranicza wyniki wyszukiwania;
offset optional	Typ:  number optional Pozycja znaku w słowie wejściowym, w której usługa używa tekstu do prognozowania (pozycja kursora w polu wejściowym).
origin optional	Typ:  LatLng|LatLngLiteral optional Lokalizacja, z której obliczana jest wartość AutocompletePrediction.distance_meters.
radius optional	Wycofane: radius zostało wycofane w maju 2023 r. Zamiast niej użyj zasad AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  number optional Promień obszaru używanego do ustawienia prognozy. Wartość radius jest podawana w metrach i zawsze musi być powiązana z właściwością location. Możesz też użyć właściwości bounds.
region optional	Typ:  string optional Kod regionu używany do formatowania wyników i ich filtrowania. Nie ogranicza sugestii do tego kraju. Kod regionu może mieć 2-znakową wartość domeny krajowej 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 jej 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 służący do grupowania poszczególnych żądań w sesje.
types optional	Typ:  Array<string> optional Typy prognoz, które mają być zwracane. Informacje o obsługiwanych typach znajdziesz w  przewodniku dla programistów. Jeśli nie podasz żadnych typów, zwrócone zostaną wszystkie typy.

Interfejs AutocompleteResponse

google.maps.places.AutocompleteResponseinterfejs

Odpowiedź z automatycznego uzupełniania zwrócona przez wywołanie AutocompleteService.getPlacePredictions zawierająca listę AutocompletePrediction.

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

interfejs QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequestinterfejs

Prośba o wypełnianie automatyczne zapytań została wysłana do QueryAutocompleteService.

Właściwości
input	Typ:  string Wprowadzony przez użytkownika ciąg znaków.
bounds optional	Typ:  LatLngBounds|LatLngBoundsLiteral optional Przedziały błędów prognozy. Prognozy będą uwzględniać dany bounds, ale nie będą się do niego ograniczać. Jeśli ustawiona jest wartość bounds, zarówno location, jak i radius zostaną zignorowane.
location optional	Typ:  LatLng optional Lokalizacja służąca do ukierunkowania prognozy. Przewidywania będą uwzględniać dane z określonych location i radius. Możesz też użyć właściwości bounds.
offset optional	Typ:  number optional Pozycja znaku w słowie wejściowym, w której usługa używa tekstu do prognozowania (pozycja kursora w polu wejściowym).
radius optional	Typ:  number optional Promień obszaru używanego do ustawienia prognozy. Wartość radius jest podawana w metrach i zawsze musi być powiązana z właściwością location. Możesz też użyć właściwości bounds.

Interfejs ComponentRestrictions

google.maps.places.ComponentRestrictionsinterfejs

Określa ograniczenia komponentów, które można stosować w usłudze autouzupełniania.

Właściwości
country optional	Typ:  string|Array<string> optional Ogranicza prognozy do określonego kraju (kod kraju w formacie ISO 3166-1 alfa-2, bez względu na wielkość liter). na przykład 'us', 'br' lub 'au'. Możesz podać 1 kod lub tablicę maksymalnie 5 kodów.

interfejs AutocompletePrediction,

google.maps.places.AutocompletePredictioninterfejs

Reprezentuje pojedynczą podpowiedź autouzupełniania.

Właściwości
description	Typ:  string Jest to niesformatowana wersja zapytania zaproponowanego przez usługę Miejsca.
matched_substrings	Typ:  Array<PredictionSubstring> Zbiór podciągów w opisie miejsca, które pasują do elementów wprowadzonych przez użytkownika i mogą być użyte do podświetlenia tych podciągów. Każdy ciąg podrzędny jest identyfikowany przez przesunięcie i długość wyrażoną w znakach Unicode.
place_id	Typ:  string Identyfikator miejsca, którego można użyć do pobrania szczegółów dotyczących tego miejsca za pomocą usługi dotyczącej szczegółów miejsca (zob. PlacesService.getDetails).
structured_formatting	Typ:  StructuredFormatting uporządkowane informacje o opisie miejsca, podzielone na tekst główny i dodatkowy, w tym tablicę dopasowanych podciągów znaków z danych wprowadzanych automatycznie, zidentyfikowanych przez przesunięcie i długość wyrażoną w znakach Unicode;
terms	Typ:  Array<PredictionTerm> Informacje o poszczególnych terminach w powyższym opisie, 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, np. 'establishment' lub 'geocode'.
distance_meters optional	Typ:  number optional Odległość w metrach od miejsca do AutocompletionRequest.origin.

Interfejs QueryAutocompletePrediction

google.maps.places.QueryAutocompletePredictioninterfejs

Reprezentuje pojedynczą podpowiedź autouzupełniania zapytania.

Właściwości
description	Typ:  string Jest to niesformatowana wersja zapytania zaproponowanego przez usługę Miejsca.
matched_substrings	Typ:  Array<PredictionSubstring> Zbiór podciągów w opisie miejsca, które pasują do elementów wprowadzonych przez użytkownika i mogą być użyte do podświetlenia tych podciągów. Każdy ciąg podrzędny jest identyfikowany przez przesunięcie i długość wyrażoną w znakach Unicode.
terms	Typ:  Array<PredictionTerm> informacje o poszczególnych warunkach w opisie powyżej. Najpierw podaj terminy określające kategorię (np. „restauracja”). Adresy są wyświetlane od najbardziej do najmniej szczegółowych. Na przykład „Warszawa” i „PL”.
place_id optional	Typ:  string optional Dostępne tylko wtedy, gdy przewidywany wynik to miejsce. Identyfikator miejsca, którego można użyć do pobrania szczegółów dotyczących tego miejsca za pomocą usługi dotyczącej szczegółów miejsca (zob. PlacesService.getDetails).

Interfejs PredictionTerm

google.maps.places.PredictionTerminterfejs

Reprezentuje termin prognozy.

Właściwości
offset	Typ:  number Odstęp (w znakach Unicode) od początku tego terminu w opisie miejsca.
value	Typ:  string Wartość tego hasła, np. „Taco Bell”.

Interfejs PredictionSubstring

google.maps.places.PredictionSubstringinterfejs

Reprezentuje podciąg znaków prognozy.

Właściwości
length	Typ:  number Długość podciągu.
offset	Typ:  number Odsunięcie początku podłańcucha w ciągu znaków opisu.

Interfejs StructuredFormatting

google.maps.places.StructuredFormattinginterfejs

Zawiera uporządkowane informacje o opisie miejsca, podzielone na tekst główny i dodatkowy, w tym tablicę dopasowanych podciągów znaków z danych wprowadzanych automatycznie, zidentyfikowanych za pomocą przesunięcia i długości wyrażonej w znakach Unicode.

Właściwości
main_text	Typ:  string Jest to główny tekst niesformatowanego opisu miejsca zaproponowanego przez usługę Miejsca. Zwykle jest to nazwa miejsca.
main_text_matched_substrings	Typ:  Array<PredictionSubstring> Zbiór podciągów w głównym tekście, które pasują do elementów wprowadzonych przez użytkownika, odpowiedni do podświetlania tych podciągów. Każdy ciąg podrzędny jest identyfikowany przez przesunięcie i długość wyrażoną w znakach Unicode.
secondary_text	Typ:  string Jest to drugi tekst w niesformatowanym opisie miejsca zaproponowanym przez usługę Miejsca. Zwykle jest to lokalizacja miejsca.