Autocomplete Data (new)

Interfejs AutocompleteRequest

google.maps.places.AutocompleteRequestinterfejs

Interfejs prośby w usłudze AutocompleteSuggestion.fetchAutocompleteSuggestions.
input
Typ:  string
Tekst, w którym ma być przeprowadzone wyszukiwanie.
includedPrimaryTypes optional
Typ:  Array<string> optional
Uwzględnij podstawowy Typ miejsca (np. „restaurant” lub „gas_station”).

Miejsce jest zwracane tylko wtedy, gdy jego podstawowy typ znajduje się na tej liście. Możesz podać maksymalnie 5 wartości. Jeśli nie podasz żadnych typów, zwrócone zostaną wszystkie typy miejsc.
includedRegionCodes optional
Typ:  Array<string> optional
Uwzględniaj tylko wyniki z określonych regionów, które są określone jako maksymalnie 15-cyfrowe kody regionów CLDR. Pusty zbiór nie ograniczy wyników. Jeśli ustawisz zarówno parametr locationRestriction, jak i includedRegionCodes, wyniki znajdą się w obszarze ich przecięcia.
inputOffset optional
Typ:  number optional
Odsunięcie znaku Unicode o wartość input, liczone od 0, wskazujące pozycję kursora w elementach input. Pozycja kursora może wpływać na prognozy zwracane przez usługę. Jeśli nie podasz tu żadnej wartości, zostanie użyta długość input.
language optional
Typ:  string optional
Język, w którym mają być zwracane wyniki. Domyślnie będzie używany język ustawiony w przeglądarce. Wyniki mogą być podane w różnych językach, jeśli język używany w input różni się od języka language lub jeśli zwrócone miejsce nie ma tłumaczenia z języka lokalnego na language.
locationBias optional
Typ:  LocationBias optional
Wyniki są przybliżone do określonej lokalizacji.

Należy ustawić co najwyżej jedną z tych właściwości: locationBias lub locationRestriction. Jeśli żadna z nich nie zostanie ustawiona, wyniki będą obarczone błędem wynikającym z adresu IP, co oznacza, że adres IP zostanie przypisany do nieprecyzyjnej lokalizacji i użyty jako sygnał zastępczy.
locationRestriction optional
Typ:  LocationRestriction optional
Ogranicz wyniki do określonej lokalizacji.

Należy ustawić co najwyżej jedną z tych właściwości: locationBias lub locationRestriction. Jeśli żadna z nich nie zostanie ustawiona, wyniki będą obarczone błędem wynikającym z adresu IP, co oznacza, że adres IP zostanie przypisany do nieprecyzyjnej lokalizacji i użyty jako sygnał zastępczy.
origin optional
Typ:  LatLng|LatLngLiteral optional
Punkt początkowy, z którego ma być obliczona odległość geodezyjna do punktu docelowego (zwracana jako PlacePrediction.distanceMeters). Jeśli ta wartość zostanie pominięta, odległość geodezyjna nie zostanie zwrócona.
region optional
Typ:  string optional
Kod regionu określony jako dwuznakowy kod regionu CLDR. Ma to wpływ na formatowanie adresu, ranking wyników i może wpływać na wyniki zwracane. Nie ogranicza to wyników do wybranego regionu.
sessionToken optional
Typ:  AutocompleteSessionToken optional
Token identyfikujący sesję autouzupełniania na potrzeby rozliczeń. Wygeneruj nowy token sesji za pomocą AutocompleteSessionToken.

Sesja rozpoczyna się, gdy użytkownik zacznie wpisywać zapytanie, a kończy, gdy wybierze miejsce i nawiąże połączenie Place.fetchFields. Każda sesja może zawierać wiele zapytań, po których następuje jedno wywołanie funkcji fetchFields. Dane logowania używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. Po zakończeniu sesji token nie jest już ważny. Aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli parametr sessionToken zostanie pominięty lub jeśli token sesji zostanie użyty ponownie, sesja zostanie obciążona tak, jakby nie podano tokena sesji (za każde żądanie naliczana jest opłata).

Zalecamy przestrzeganie tych wytycznych:
  • Używanie tokenów sesji we wszystkich wywołaniach autouzupełniania w Google Places.
  • generować nowy token dla każdej sesji.
  • Pamiętaj, aby w przypadku każdej nowej sesji przekazać unikalny token sesji. Użycie tego samego tokena w kilku sesjach spowoduje, że za każde żądanie zostanie naliczona osobna opłata.

klasa AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken class

Reprezentuje token sesji używany do śledzenia sesji autouzupełniania.

Dostęp przez połączenie telefoniczne const {AutocompleteSessionToken} = await google.maps.importLibrary("places"). Zobacz Biblioteki w Maps JavaScript API.
AutocompleteSessionToken
AutocompleteSessionToken()
Parametry: brak
Tworzy nową instancję AutocompleteSessionToken.

Klasa AutocompleteSuggestion

google.maps.places.AutocompleteSuggestion class

Wynik sugestii autouzupełniania.

Dostęp przez połączenie telefoniczne const {AutocompleteSuggestion} = await google.maps.importLibrary("places"). Zobacz Biblioteki w Maps JavaScript API.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Parametry: 
Wartość zwracana:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
Pobiera listę sugestii autouzupełniania.
placePrediction
Typ:  PlacePrediction optional
Zawiera czytelną dla człowieka nazwę zwróconego wyniku. W przypadku wyników dotyczących lokalizacji jest to zwykle nazwa i adres firmy.

klasa PlacePrediction

google.maps.places.PlacePrediction class

Wyniki prognozy dla podpowiedzi autouzupełniania Miejsce.

Dostęp przez połączenie telefoniczne const {PlacePrediction} = await google.maps.importLibrary("places"). Zobacz Biblioteki w Maps JavaScript API.
distanceMeters
Typ:  number optional
Długość geodezyjna w metrach od origin, jeśli origin jest określony.
mainText
Typ:  FormattableText optional
Reprezentuje nazwę Miejsca.
placeId
Typ:  string
Unikalny identyfikator sugerowanego Miejsca. Można go używać w innych interfejsach API, które akceptują identyfikatory miejsc.
secondaryText
Typ:  FormattableText optional
Reprezentują dodatkowe cechy rozróżniające (np. miasto lub region), które umożliwiają dokładniejsze zidentyfikowanie Miejsca.
text
Zawiera czytelną dla człowieka nazwę zwróconego wyniku. W przypadku wyników dotyczących lokalizacji jest to zwykle nazwa i adres firmy.

text jest zalecana deweloperom, którzy chcą wyświetlać pojedynczy element interfejsu. Deweloperzy, którzy chcą wyświetlać 2 oddzielne, ale powiązane elementy interfejsu, mogą zamiast tego użyć operatorów PlacePrediction.mainText i PlacePrediction.secondaryText.
types
Typ:  Array<string>
Lista typów, które dotyczą tego Miejsca, z tabeli A lub tabeli B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.
toPlace
toPlace()
Parametry: brak
Wartość zwracana:  Place
Zwraca reprezentację miejsca z danych PlacePrediction. Aby uzyskać pełne informacje o miejscu docelowym, musisz wykonać kolejne wywołanie do Place.fetchFields.

Klasa StringRange

google.maps.places.StringRange class

Wyznacza podciąg w danym tekście.

Dostęp przez połączenie telefoniczne const {StringRange} = await google.maps.importLibrary("places"). Zobacz Biblioteki w Maps JavaScript API.
endOffset
Typ:  number
Odsunięcie od ostatniego znaku Unicode podłańcucha (nie wliczając go).
startOffset
Typ:  number
Odsunięcie pierwszego znaku Unicode podłańcucha (włącznie) liczone od 0.

FormattableText class

google.maps.places.FormattableText class

Tekst przedstawiający prognozę dotyczącą miejsca. Tekst może być użyty w takiej postaci lub sformatowany.

Dostęp przez połączenie telefoniczne const {FormattableText} = await google.maps.importLibrary("places"). Zobacz Biblioteki w Maps JavaScript API.
matches
Lista zakresów ciągów tekstowych określająca, gdzie żądanie wejściowe pasuje do FormattableText.text. Za ich pomocą możesz formatować określone części wyrażenia text. Podciągi mogą nie być dokładnymi dopasowaniami do AutocompleteRequest.input, jeśli dopasowanie zostało określone na podstawie kryteriów innych niż dopasowanie ciągu znaków (np. poprawki ortograficzne lub transliteracje). Te wartości to przesunięcie znaku Unicode o wartość FormattableText.text. Zakresy są zawsze sortowane według rosnących wartości przesunięcia.
text
Typ:  string
Tekst, który można użyć w takiej postaci lub sformatowany za pomocą FormattableText.matches.