Places Autocomplete Service

Klasa AutocompleteService

google.maps.places.AutocompleteService zajęcia

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

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

Zespół
AutocompleteService	AutocompleteService() Parametry: brak Tworzy nową instancję 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 AutocompletePrediction oraz wartość PlacesServiceStatus jako argument. Wartość zwrotu:  Promise<AutocompleteResponse> Pobiera podpowiedzi autouzupełniania miejsc na podstawie dostarczonego żądania autouzupełniania.
getQueryPredictions	getQueryPredictions(request, callback) Parametry:  request:  QueryAutocompletionRequest żądanie autouzupełniania zapytania. callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void Wywołanie zwrotne akceptujące tablicę obiektów QueryAutocompletePrediction oraz wartość PlacesServiceStatus jako argument. Zwracana wartość: brak Pobiera prognozy autouzupełniania zapytania na podstawie podanego żądania autouzupełniania zapytania.

Interfejs AutocompletionRequest

google.maps.places.AutocompletionRequest interfejs

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

Właściwości
input	Typ:  string Użytkownik wpisał ciąg wejściowy.
bounds optional	Wycofane: od maja 2023 r. wersja bounds została wycofana. Zamiast nich używaj kolumn AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  LatLngBounds|LatLngBoundsLiteral optional Ograniczenia promowania prognoz. Przewidywania będą stronnicze, co dotyczy danych bounds, ale nie tylko. Jeśli ustawiona jest wartość bounds, wartości location i radius zostaną zignorowane.
componentRestrictions optional	Typ:  ComponentRestrictions optional Ograniczenia komponentów. Ograniczenia dotyczące komponentów umożliwiają ograniczenie prognoz tylko do tych, które znajdują się w komponencie nadrzędnym. Może to być na przykład kraj.
language optional	Typ:  string optional Identyfikator języka, w którym powinny być zwracane 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	Wycofane: od maja 2023 r. wersja location została wycofana. Zamiast nich używaj kolumn AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  LatLng optional Lokalizacja na potrzeby promowania prognozy. Przewidywania będą stronnicze, co będą miały wpływ na te dane: location i radius. Można też użyć parametru bounds.
locationBias optional	Typ:  LocationBias optional Delikatna granica lub wskazówka do wykorzystania podczas wyszukiwania miejsc.
locationRestriction optional	Typ:  LocationRestriction optional Ograniczenia nakładania wyników wyszukiwania.
offset optional	Typ:  number optional Pozycja znaku w wyszukiwanym haśle, na którym usługa używa tekstu do przewidywania (pozycja kursora w polu do wprowadzania danych).
origin optional	Typ:  LatLng|LatLngLiteral optional Lokalizacja, z której obliczany jest AutocompletePrediction.distance_meters.
radius optional	Wycofane: od maja 2023 r. wersja radius została wycofana. Zamiast nich używaj kolumn AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  number optional Promień obszaru używanego do promowania wyników. Element radius jest podawany w metrach i zawsze musi mu towarzyszyć właściwość location. Można też użyć parametru bounds.
region optional	Typ:  string optional Kod regionu, który służy do formatowania i filtrowania wyników. Nie ogranicza ona sugestii do tego kraju. Kod regionu akceptuje dwuznaczną wartość ccTLD („domena najwyższego poziomu”). Większość kodów domen ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład domena ccTLD w Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie oznacza to „Wielka Brytania i Irlandia Północna”).
sessionToken optional	Typ:  AutocompleteSessionToken optional Unikalny plik referencyjny służący do łączenia poszczególnych żądań w sesje.
types optional	Typ:  Array<string> optional Typy prognoz, które mają zostać zwrócone. Listę obsługiwanych typów znajdziesz w przewodniku dla programistów. Jeśli nie podasz żadnych typów, zwrócone zostaną wszystkie typy.

Interfejs AutocompleteResponse

google.maps.places.AutocompleteResponse interfejs

Odpowiedź autouzupełniania zwracana przez wywołanie AutocompleteService.getPlacePredictions, która zawiera listę elementów AutocompletePrediction.

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

Interfejs QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequest interfejs

Żądanie autouzupełniania zapytania zostanie wysłane do interfejsu QueryAutocompleteService.

Właściwości
input	Typ:  string Użytkownik wpisał ciąg wejściowy.
bounds optional	Typ:  LatLngBounds|LatLngBoundsLiteral optional Ograniczenia promowania prognoz. Przewidywania będą stronnicze, co dotyczy danych bounds, ale nie tylko. Jeśli ustawiona jest wartość bounds, wartości location i radius zostaną zignorowane.
location optional	Typ:  LatLng optional Lokalizacja na potrzeby promowania prognozy. Przewidywania będą stronnicze, co będą miały wpływ na te dane: location i radius. Można też użyć parametru bounds.
offset optional	Typ:  number optional Pozycja znaku w wyszukiwanym haśle, na którym usługa używa tekstu do przewidywania (pozycja kursora w polu do wprowadzania danych).
radius optional	Typ:  number optional Promień obszaru używanego do promowania wyników. Element radius jest podawany w metrach i zawsze musi mu towarzyszyć właściwość location. Można też użyć parametru bounds.

Interfejs ComponentRestrictions

google.maps.places.ComponentRestrictions interfejs

Określa ograniczenia komponentów, które mogą być używane z usługą autouzupełniania.

Właściwości
country optional	Typ:  string|Array<string> optional Ogranicza podpowiedzi do wybranego kraju (kod kraju w formacie ISO 3166-1 alfa-2, wielkość liter nie ma znaczenia). na przykład 'us', 'br' lub 'au'. Możesz podać 1 jeden lub tabelę z maksymalnie 5 ciągami znaków z kodem kraju.

Interfejs AutocompletePrediction

google.maps.places.AutocompletePrediction interfejs

Reprezentuje pojedynczą podpowiedź autouzupełniania.

Właściwości
description	Typ:  string To jest niesformatowana wersja zapytania zasugerowana przez usługę Miejsca.
matched_substrings	Typ:  Array<PredictionSubstring> Zbiór podłańcuchów w opisie miejsca, które pasują do elementów wpisanych przez użytkownika, przystosowanych do wyróżniania tych podłańcuchów. Każdy podłańcuch jest wskazywany przez przesunięcie i długość wyrażoną w znakach Unicode.
place_id	Typ:  string Identyfikator miejsca, który umożliwia pobranie informacji na temat tego miejsca przy użyciu usługi informacji o miejscu (patrz PlacesService.getDetails).
structured_formatting	Typ:  StructuredFormatting Uporządkowane informacje o opisie miejsca podzielone na tekst główny i dodatkowy, w tym tablicę dopasowanych podłańcuchów z danych autouzupełniania, identyfikowanych 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ść miejsca w metrach od: AutocompletionRequest.origin.

Interfejs QueryAutocompletePrediction

google.maps.places.QueryAutocompletePrediction interfejs

Reprezentuje pojedynczą prognozę autouzupełniania zapytania.

Właściwości
description	Typ:  string To jest niesformatowana wersja zapytania zasugerowana przez usługę Miejsca.
matched_substrings	Typ:  Array<PredictionSubstring> Zbiór podłańcuchów w opisie miejsca, które pasują do elementów wpisanych przez użytkownika, przystosowanych do wyróżniania tych podłańcuchów. Każdy podłańcuch jest wskazywany przez przesunięcie i długość wyrażoną w znakach Unicode.
terms	Typ:  Array<PredictionTerm> Informacje o poszczególnych terminach podane w opisie powyżej. Terminy kategorialne są wyświetlane na początku (np. „restauracja”). Hasła adresowe są wyświetlane od najbardziej do najmniej szczegółowych. Na przykład „Kraków” i „Kalifornia”.
place_id optional	Typ:  string optional Opcja dostępna tylko wtedy, gdy prognoza obejmuje miejsce. Identyfikator miejsca, który umożliwia pobranie informacji na temat tego miejsca przy użyciu usługi informacji o miejscu (patrz PlacesService.getDetails).

Interfejs PredictionTerm

google.maps.places.PredictionTerm interfejs

Reprezentuje termin prognozy.

Właściwości
offset	Typ:  number Przesunięcie (w znakach Unicode) początku tego hasła w opisie miejsca.
value	Typ:  string Wartość tego terminu, 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 względem początku podłańcucha w ciągu opisu.

Interfejs StructuredFormatting

google.maps.places.StructuredFormatting interfejs

Zawiera uporządkowane informacje o opisie miejsca podzielone na tekst główny i dodatkowy, w tym tablicę pasujących podłańcuchów z danych autouzupełniania, określonych przesunięciem i długością wyrażoną w znakach Unicode.

Właściwości
main_text	Typ:  string Jest to główna część tekstowa niesformatowanego opisu miejsca sugerowanego przez usługę Miejsca. Zwykle jest to nazwa miejsca.
main_text_matched_substrings	Typ:  Array<PredictionSubstring> Zbiór podłańcuchów w tekście głównym, które pasują do elementów wpisanych przez użytkownika i mogą służyć do wyróżniania tych podłańcuchów. Każdy podłańcuch jest wskazywany przez przesunięcie i długość wyrażoną w znakach Unicode.
secondary_text	Typ:  string Jest to drugorzędna część tekstowa niesformatowanego opisu miejsca sugerowanego przez usługę Miejsca. Zwykle jest to lokalizacja miejsca.