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.

AutocompleteService
AutocompleteService()
Parametry: brak
Tworzy nową instancję obiektu AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Parametry: 
Wartość zwrotu:  Promise<AutocompleteResponse>
Pobiera podpowiedzi autouzupełniania miejsc na podstawie dostarczonego żądania autouzupełniania.
getQueryPredictions
getQueryPredictions(request, callback)
Parametry: 
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.

input
Typ:  string
Użytkownik wpisał ciąg wejściowy.
bounds 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
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
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.

predictions

Interfejs QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequest interfejs

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

input
Typ:  string
Użytkownik wpisał ciąg wejściowy.
bounds 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.

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.

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.

description
Typ:  string
To jest niesformatowana wersja zapytania zasugerowana przez usługę Miejsca.
matched_substrings
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
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
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.

description
Typ:  string
To jest niesformatowana wersja zapytania zasugerowana przez usługę Miejsca.
matched_substrings
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
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.

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.

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.

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
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.