Places Autocomplete Service

Klasa AutocompleteService

google.maps.places.AutocompleteService zajęcia

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.
AutocompleteService
AutocompleteService()
Parametry: brak
Tworzy nową instancję AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Parametry: 
Zwracana wartość:  Promise<AutocompleteResponse>
Pobiera podpowiedzi autouzupełniania miejsc na podstawie przesłanego żądania autouzupełniania.
getQueryPredictions
getQueryPredictions(request, callback)
Parametry: 
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.
input
Typ:  string
Użytkownik wprowadził ciąg znaków.
bounds 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
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
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.
predictions
Lista AutocompletePrediction.

QueryAutocompletionRequest interface

google.maps.places.QueryAutocompletionRequestinterfejs

Prośba QueryAutocompletion, która ma zostać wysłana do QueryAutocompleteService.
input
Typ:  string
Użytkownik wprowadził ciąg znaków.
bounds 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.
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.
description
Typ:  string
Jest to niesformatowana wersja zapytania sugerowanego przez usługę Miejsca.
matched_substrings
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
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
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.
description
Typ:  string
Jest to niesformatowana wersja zapytania sugerowanego przez usługę Miejsca.
matched_substrings
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
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.
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.
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.
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
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.