Places Autocomplete Service (deprecated)

Klasa AutocompleteService

klasa google.maps.places.AutocompleteService
biblioteka "places"

Wycofane: 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 google.maps.places.AutocompleteService, ale zalecamy używanie AutocompleteSuggestion zamiast google.maps.places.AutocompleteService. Chociaż usługa google.maps.places.AutocompleteService będzie nadal otrzymywać poprawki błędów w przypadku poważnych regresji, istniejące błędy w usłudze google.maps.places.AutocompleteService nie będą rozwiązywane. O zakończeniu wsparcia poinformujemy 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.

const {AutocompleteService} = await google.maps.importLibrary("places");

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, które jako argument akceptuje tablicę obiektów AutocompletePrediction i wartość PlacesServiceStatus. Wartość zwracana: Promise<AutocompleteResponse> Pobiera podpowiedzi autouzupełniania miejsc na podstawie przesłanego żądania autouzupełniania.
getQueryPredictions	getQueryPredictions(request, callback) Parametry: request: QueryAutocompletionRequest Żądanie autouzupełniania zapytania. callback: function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void Wywołanie zwrotne, które jako argument przyjmuje tablicę obiektów QueryAutocompletePrediction i wartość PlacesServiceStatus. Zwracana wartość: brak Pobiera podpowiedzi autouzupełniania zapytania na podstawie przesłanego żądania autouzupełniania zapytania.

Interfejs AutocompletionRequest

interfejs google.maps.places.AutocompletionRequest

Żądanie autouzupełniania, które ma zostać wysłane do: AutocompleteService.getPlacePredictions.

Właściwości
input	Typ: string Ciąg znaków wprowadzony przez użytkownika.
bounds opcjonalne	Wycofane: środowisko bounds zostało wycofane w maju 2023 r. Zamiast niej użyj zasad AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ: LatLngBounds|LatLngBoundsLiteral optional Granice odchylenia prognozy. Podpowiedzi będą faworyzować podany bounds, ale nie będą ograniczone tylko do niego. Jeśli zasada bounds jest skonfigurowana, zasady location i radius są ignorowane.
componentRestrictions opcjonalne	Typ: ComponentRestrictions optional Ograniczenia dotyczące komponentu. Ograniczenia komponentów służą do ograniczania podpowiedzi tylko do tych, które znajdują się w komponencie nadrzędnym. Na przykład kraj.
language opcjonalne	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ę, ale sugestie nie są ograniczone do tego języka. Zobacz listę obsługiwanych języków.
location opcjonalne	Wycofane: środowisko location zostało wycofane w maju 2023 r. Zamiast niej użyj zasad AutocompletionRequest.locationBias i AutocompletionRequest.locationRestriction. Typ: LatLng optional Lokalizacja na potrzeby dostosowywania podpowiedzi. Podpowiedzi będą faworyzować podane wartości location i radius. Możesz też użyć bounds.
locationBias opcjonalne	Typ: LocationBias optional Miękka granica lub wskazówka do użycia podczas wyszukiwania miejsc.
locationRestriction opcjonalne	Typ: LocationRestriction optional Granice ograniczające wyniki wyszukiwania.
offset opcjonalne	Typ: number optional Pozycja znaku w wyszukiwanym haśle, w której usługa używa tekstu do podpowiedzi (pozycja kursora w polu do wprowadzania danych).
origin opcjonalne	Typ: LatLng|LatLngLiteral optional Lokalizacja, na podstawie której obliczana jest wartość AutocompletePrediction.distance_meters.
radius opcjonalne	Wycofane: środowisko 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 korygowania podpowiedzi. Wartość radius jest podawana w metrach i zawsze musi jej towarzyszyć właściwość location. Możesz też użyć bounds.
region opcjonalne	Typ: string optional Kod regionu, który jest używany do formatowania i filtrowania wyników. Nie ogranicza 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 domena 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 opcjonalne	Typ: AutocompleteSessionToken optional Unikalny identyfikator używany do grupowania poszczególnych żądań w sesje.
types opcjonalne	Typ: Array<string> optional Typy podpowiedzi, które mają być zwracane. Obsługiwane typy znajdziesz w  przewodniku dla deweloperów. Jeśli nie określisz żadnych typów, zostaną zwrócone wszystkie typy.

Interfejs AutocompleteResponse

interfejs google.maps.places.AutocompleteResponse

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

Właściwości
predictions	Typ: Array<AutocompletePrediction> Lista elementów typu AutocompletePrediction.

QueryAutocompletionRequest interface

interfejs google.maps.places.QueryAutocompletionRequest

Żądanie QueryAutocompletion, które ma zostać wysłane do QueryAutocompleteService.

Właściwości
input	Typ: string Ciąg znaków wprowadzony przez użytkownika.
bounds opcjonalne	Typ: LatLngBounds|LatLngBoundsLiteral optional Granice odchylenia prognozy. Podpowiedzi będą faworyzować podany bounds, ale nie będą ograniczone tylko do niego. Jeśli zasada bounds jest skonfigurowana, zasady location i radius są ignorowane.
location opcjonalne	Typ: LatLng optional Lokalizacja na potrzeby dostosowywania podpowiedzi. Podpowiedzi będą faworyzować podane wartości location i radius. Możesz też użyć bounds.
offset opcjonalne	Typ: number optional Pozycja znaku w wyszukiwanym haśle, w której usługa używa tekstu do podpowiedzi (pozycja kursora w polu do wprowadzania danych).
radius opcjonalne	Typ: number optional Promień obszaru używanego do korygowania podpowiedzi. Wartość radius jest podawana w metrach i zawsze musi jej towarzyszyć właściwość location. Możesz też użyć bounds.

Interfejs ComponentRestrictions

interfejs google.maps.places.ComponentRestrictions

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

Właściwości
country opcjonalne	Typ: string|Array<string> optional Ogranicza podpowiedzi do określonego kraju (kod kraju ISO 3166-1 alfa-2, wielkość liter nie jest rozróżniana). na przykład 'us', 'br' lub 'au'. Możesz podać 1 kod lub tablicę zawierającą maksymalnie 5 ciągów kodów krajów.

Interfejs AutocompletePrediction

interfejs google.maps.places.AutocompletePrediction

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> Zbiór podłańcuchów w opisie miejsca, które pasują do elementów wprowadzonych przez użytkownika, odpowiednich do wyróżnienia tych podłańcuchów. Każdy podłańcuch 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ółowych informacji o tym miejscu za pomocą usługi informacji o miejscu (patrz PlacesService.getDetails).
structured_formatting	Typ: StructuredFormatting Uporządkowane informacje o opisie miejsca, podzielone na tekst główny i tekst dodatkowy, w tym tablica dopasowanych podłańcuchów z danych wejściowych autouzupełniania, zidentyfikowanych przez przesunięcie i długość, wyrażone 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 podpowiedź, np. 'establishment' lub 'geocode'.
distance_meters opcjonalne	Typ: number optional Odległość w metrach od miejsca AutocompletionRequest.origin.

Interfejs QueryAutocompletePrediction

interfejs google.maps.places.QueryAutocompletePrediction

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> Zbiór podłańcuchów w opisie miejsca, które pasują do elementów wprowadzonych przez użytkownika, odpowiednich do wyróżnienia tych podłańcuchów. Każdy podłańcuch 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 wyświetlane są hasła kategorialne (np. „restauracja”). Terminy adresowe są wyświetlane od najbardziej do najmniej szczegółowych. Na przykład „San Francisco” i „CA”.
place_id opcjonalne	Typ: string optional Dostępne tylko wtedy, gdy podpowiedź dotyczy miejsca. Identyfikator miejsca, którego można użyć do pobrania szczegółowych informacji o tym miejscu za pomocą usługi informacji o miejscu (patrz PlacesService.getDetails).

Interfejs PredictionTerm

interfejs google.maps.places.PredictionTerm

Reprezentuje hasło podpowiedzi.

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, np. „Taco Bell”.

Interfejs PredictionSubstring

interfejs google.maps.places.PredictionSubstring

Reprezentuje podłańcuch podpowiedzi.

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

StructuredFormatting interface

interfejs google.maps.places.StructuredFormatting

Zawiera uporządkowane informacje o opisie miejsca, podzielone na tekst główny i tekst dodatkowy, w tym tablicę dopasowanych podłańcuchó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 To jest 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 głównym tekście, które pasują do elementów wprowadzonych przez użytkownika, odpowiednich do wyróżnienia tych podłańcuchów. Każdy podłańcuch jest identyfikowany przez przesunięcie i długość, wyrażone w znakach Unicode.
secondary_text	Typ: string Jest to dodatkowy tekst niesformatowanego opisu miejsca sugerowanego przez usługę Miejsca. Zwykle jest to lokalizacja miejsca.