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.

Klasa AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken zajęcia

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

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

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

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.