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.
AutocompleteService
AutocompleteService()
Parametry: brak
Tworzy nową instancję AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Parametry: 
Wartość zwracana:  Promise<AutocompleteResponse>
Pobiera przewidywane wyniki autouzupełniania miejsca na podstawie przesłanego zapytania o autouzupełnianie.
getQueryPredictions
getQueryPredictions(request, callback)
Parametry: 
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.
input
Typ:  string
Wprowadzony przez użytkownika ciąg znaków.
bounds 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
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
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.
predictions
Lista AutocompletePrediction.

interfejs QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequestinterfejs

Prośba o wypełnianie automatyczne zapytań została wysłana do QueryAutocompleteService.
input
Typ:  string
Wprowadzony przez użytkownika ciąg znaków.
bounds 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.
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.
description
Typ:  string
Jest to niesformatowana wersja zapytania zaproponowanego przez usługę Miejsca.
matched_substrings
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
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
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.
description
Typ:  string
Jest to niesformatowana wersja zapytania zaproponowanego przez usługę Miejsca.
matched_substrings
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
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.
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.
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.
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
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.