Places Autocomplete Service

Klasa AutocompleteService

google.maps.places.AutocompleteService zajęcia

Wycofano: od 1 marca 2025 r. usługa google.maps.places.AutocompleteService nie jest dostępna dla nowych klientów. Zamiast nich użyj kolumn: AutocompleteSuggestion. Obecnie nie planujemy wycofania usługi google.maps.places.AutocompleteService, ale zalecamy korzystanie z usługi AutocompleteSuggestion zamiast niej. Usługa google.maps.places.AutocompleteService będzie nadal otrzymywać poprawki błędów w przypadku poważnych regresji, ale istniejące błędy w tej usłudze nie będą usuwane. Powiadomimy Cię o tym z co najmniej 12-miesięcznym wyprzedzeniem. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/legacy, a przewodnik po migracji na stronie https://developers.google.com/maps/documentation/javascript/places-migration-overview.

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

Dostęp przez połączenie pod numer 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 żądanie autouzupełniania. callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional wywołanie zwrotne akceptujące tablicę obiektów AutocompletePrediction i wartość PlacesServiceStatus jako argument. Zwracana wartość:  Promise<AutocompleteResponse> Pobiera podpowiedzi autouzupełniania miejsc na podstawie przesłanego żądania autouzupełniania.
getQueryPredictions	getQueryPredictions(request, callback) Parametry:  request:  QueryAutocompletionRequest żądanie automatycznego uzupełniania zapytania. callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void funkcja zwrotna przyjmująca jako argument tablicę obiektów QueryAutocompletePrediction i wartość PlacesServiceStatus. Zwracana wartość: brak Pobiera podpowiedzi autouzupełniania zapytań na podstawie przesłanego żądania autouzupełniania zapytań.

AutocompletionRequest interfejs

google.maps.places.AutocompletionRequestinterfejs

Prośba o autouzupełnianie, która ma zostać wysłana na adres AutocompleteService.getPlacePredictions.

Właściwości
input	Typ:  string Użytkownik wprowadził ciąg znaków.
bounds optional	Wycofane: bounds zostało wycofane w maju 2023 r. Zamiast niej używaj kolumn AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  LatLngBounds|LatLngBoundsLiteral optional Granice odchylenia prognozy. Prognozy będą faworyzować podany bounds, ale nie będą się do niego ograniczać. Jeśli ustawiona jest wartość bounds, zarówno location, jak i radius są ignorowane.
componentRestrictions optional	Typ:  ComponentRestrictions optional Ograniczenia dotyczące komponentu. Ograniczenia komponentu służą do ograniczania prognoz tylko 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ą mieć wyższą pozycję, 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żywaj kolumn AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  LatLng optional Lokalizacja na potrzeby określania prawdopodobieństwa prognozy. Prognozy będą faworyzować podane wartości location i radius. Możesz też użyć bounds.
locationBias optional	Typ:  LocationBias optional Miękka granica lub wskazówka używana podczas wyszukiwania miejsc.
locationRestriction optional	Typ:  LocationRestriction optional Granice ograniczające wyniki wyszukiwania.
offset optional	Typ:  number optional Pozycja znaku w terminie 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 obliczany jest parametr AutocompletePrediction.distance_meters.
radius optional	Wycofane: radius zostało wycofane w maju 2023 r. Zamiast niej używaj kolumn AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ:  number optional Promień obszaru używanego do określania prognoz. Wartość radius jest podawana w metrach i zawsze musi jej towarzyszyć właściwość location. Możesz też użyć bounds.
region optional	Typ:  string optional Kod regionu używany do formatowania i filtrowania wyników. Nie ogranicza to sugestii do tego kraju. Kod regionu akceptuje 2-znakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” (.co.uk), a 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 używany 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 określisz typów, zostaną zwrócone wszystkie typy.

Interfejs AutocompleteResponse

google.maps.places.AutocompleteResponseinterfejs

Odpowiedź Autocomplete zwrócona przez wywołanie funkcji AutocompleteService.getPlacePredictions zawierająca listę obiektów AutocompletePrediction.

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

QueryAutocompletionRequest interface

google.maps.places.QueryAutocompletionRequestinterfejs

Prośba QueryAutocompletion, która ma zostać wysłana do QueryAutocompleteService.

Właściwości
input	Typ:  string Użytkownik wprowadził ciąg znaków.
bounds optional	Typ:  LatLngBounds|LatLngBoundsLiteral optional Granice odchylenia prognozy. Prognozy będą faworyzować podany bounds, ale nie będą się do niego ograniczać. Jeśli ustawiona jest wartość bounds, zarówno location, jak i radius są ignorowane.
location optional	Typ:  LatLng optional Lokalizacja na potrzeby określania prawdopodobieństwa prognozy. Prognozy będą faworyzować podane wartości location i radius. Możesz też użyć bounds.
offset optional	Typ:  number optional Pozycja znaku w terminie 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 określania prognoz. Wartość radius jest podawana w metrach i zawsze musi jej towarzyszyć właściwość location. Możesz też użyć 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 Alpha-2, bez rozróżniania wielkości liter). Na przykład 'us', 'br' lub 'au'. Możesz podać 1 ciąg znaków z kodem kraju lub tablicę zawierającą maksymalnie 5 takich ciągów.

Interfejs AutocompletePrediction

google.maps.places.AutocompletePredictioninterfejs

Reprezentuje pojedynczą podpowiedź autouzupełniania.

Właściwości
description	Typ:  string Jest to niesformatowana wersja zapytania sugerowanego przez usługę Miejsca.
matched_substrings	Typ:  Array<PredictionSubstring> Zestaw podciągów w opisie miejsca, które pasują do elementów wprowadzonych przez użytkownika. Można ich używać do wyróżniania tych podciągów. Każdy podciąg jest identyfikowany przez przesunięcie i długość wyrażone w znakach Unicode.
place_id	Typ:  string Identyfikator miejsca, którego można użyć do pobrania szczegółów tego miejsca za pomocą usługi szczegółów miejsca (patrz PlacesService.getDetails).
structured_formatting	Typ:  StructuredFormatting Ustrukturyzowane informacje o opisie miejsca podzielone na tekst główny i tekst dodatkowy, w tym tablica pasujących podciągów z danych wejściowych autouzupełniania, 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.

QueryAutocompletePrediction interfejs

google.maps.places.QueryAutocompletePredictioninterfejs

Reprezentuje pojedynczą podpowiedź autouzupełniania zapytania.

Właściwości
description	Typ:  string Jest to niesformatowana wersja zapytania sugerowanego przez usługę Miejsca.
matched_substrings	Typ:  Array<PredictionSubstring> Zestaw podciągów w opisie miejsca, które pasują do elementów wprowadzonych przez użytkownika. Można ich używać do wyróżniania tych podciągów. Każdy podciąg jest identyfikowany przez przesunięcie i długość wyrażone w znakach Unicode.
terms	Typ:  Array<PredictionTerm> Informacje o poszczególnych terminach w powyższym opisie. Najpierw podaj termin kategorii (np. „restauracja”). Określenia adresowe są wyświetlane od najbardziej do najmniej szczegółowych. Na przykład „San Francisco” i „CA”.
place_id optional	Typ:  string optional Dostępne tylko wtedy, gdy prognoza dotyczy miejsca. Identyfikator miejsca, którego można użyć do pobrania szczegółów tego miejsca za pomocą usługi szczegółów miejsca (patrz PlacesService.getDetails).

Interfejs PredictionTerm

google.maps.places.PredictionTerminterfejs

Reprezentuje termin podpowiedzi.

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

PredictionSubstring interfejs

google.maps.places.PredictionSubstringinterfejs

Reprezentuje podciąg prognozy.

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

Interfejs StructuredFormatting

google.maps.places.StructuredFormattinginterfejs

Zawiera informacje strukturalne o opisie miejsca podzielone na tekst główny i tekst dodatkowy, w tym tablicę pasujących podciągów z danych wejściowych autouzupełniania, zidentyfikowanych przez przesunięcie i długość wyrażone w znakach Unicode.

Właściwości
main_text	Typ:  string Jest to główna część tekstowa nieformatowanego opisu miejsca sugerowanego przez usługę Miejsca. Zwykle jest to nazwa miejsca.
main_text_matched_substrings	Typ:  Array<PredictionSubstring> Zbiór podciągów w tekście głównym, które pasują do elementów wprowadzonych przez użytkownika. Można ich używać do wyróżniania tych podciągów. Każdy podciąg jest identyfikowany przez przesunięcie i długość wyrażone w znakach Unicode.
secondary_text	Typ:  string Jest to dodatkowa część tekstowa nieformatowanego opisu miejsca sugerowanego przez usługę Miejsca. Zwykle jest to lokalizacja miejsca.