Autocomplete Data (new)

Interfejs AutocompleteRequest

google.maps.places.AutocompleteRequestinterfejs

Interfejs żądania dla AutocompleteSuggestion.fetchAutocompleteSuggestions.
input
Typ:  string
Ciąg tekstowy, w którym ma zostać przeprowadzone wyszukiwanie.
includedPrimaryTypes optional
Typ:  Array<string> optional
Zawiera podstawowy typ miejsca (np. „restaurant” lub „gas_station”).

Miejsce jest zwracane tylko wtedy, gdy jego główny typ znajduje się na tej liście. Możesz określić maksymalnie 5 wartości. Jeśli nie określisz żadnych typów, zwracane będą wszystkie typy miejsc.
includedRegionCodes optional
Typ:  Array<string> optional
Uwzględniaj tylko wyniki z określonych regionów, podanych jako maksymalnie 15 dwuznakowych kodów regionów CLDR. Pusty zbiór nie ograniczy wyników. Jeśli ustawisz zarówno locationRestriction, jak i includedRegionCodes, wyniki będą znajdować się w obszarze przecięcia.
inputOffset optional
Typ:  number optional
Przesunięcie znaku Unicode liczone od zera, wynoszące input, które wskazuje pozycję kursora w input. Pozycja kursora może wpływać na zwracane prognozy. Jeśli nie podasz tu żadnej wartości, zostanie użyta domyślna 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 wybrany w przeglądarce. Wyniki mogą być w różnych językach, jeśli język użyty w input różni się od języka language lub jeśli zwrócone miejsce nie ma tłumaczenia z języka lokalnego na język language.
locationBias optional
Typ:  LocationBias optional
Przesuwanie wyników w kierunku określonej lokalizacji.

 Należy ustawić maksymalnie jedną z tych wartości: locationBias lub locationRestriction. Jeśli żadna z tych opcji nie zostanie ustawiona, wyniki będą obciążone adresem IP, co oznacza, że adres IP zostanie przypisany do niedokładnej lokalizacji i użyty jako sygnał obciążający.
locationRestriction optional
Typ:  LocationRestriction optional
Ogranicz wyniki do określonej lokalizacji.

 Należy ustawić maksymalnie jedną z tych wartości: locationBias lub locationRestriction. Jeśli żadna z tych opcji nie zostanie ustawiona, wyniki będą obciążone adresem IP, co oznacza, że adres IP zostanie przypisany do niedokładnej lokalizacji i użyty jako sygnał obciążający.
origin optional
Typ:  LatLng|LatLngLiteral optional
Punkt początkowy, od którego należy obliczyć odległość geodezyjną do miejsca docelowego (zwracany 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 i ranking wyników, a także na to, jakie wyniki są zwracane. Nie ogranicza to wyników do określonego 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 zaczyna wpisywać zapytanie, a kończy, gdy wybierze miejsce i zadzwoni pod numer telefonu Place.fetchFields. Każda sesja może zawierać wiele zapytań, po których następuje jedno wywołanie fetchFields. Dane logowania używane w każdym żądaniu w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej sesji. Jeśli parametr sessionToken zostanie pominięty lub jeśli użyjesz ponownie tokena sesji, sesja zostanie obciążona tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno).

Zalecamy przestrzeganie tych wytycznych:
  • Używaj tokenów sesji we wszystkich wywołaniach funkcji Autouzupełnianie miejsc.
  • Generuj nowy token dla każdej sesji.
  • Pamiętaj, aby w przypadku każdej nowej sesji przekazywać unikalny token sesji. Użycie tego samego tokena w więcej niż jednej sesji spowoduje, że każde żądanie będzie rozliczane osobno.

AutocompleteSessionToken class

google.maps.places.AutocompleteSessionToken zajęcia

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

Dostęp przez połączenie pod numer 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 zajęcia

Wynik sugestii autouzupełniania.

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

PlacePrediction class

google.maps.places.PlacePrediction zajęcia

Wyniki prognozowania dla podpowiedzi autouzupełniania miejsca.

Dostęp przez połączenie pod numer const {PlacePrediction} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
distanceMeters
Typ:  number optional
Długość linii geodezyjnej w metrach od punktu origin, jeśli jest on określony.origin
mainText
Typ:  FormattableText optional
Zawiera nazwę miejsca.
placeId
Typ:  string
Unikalny identyfikator sugerowanego miejsca. Ten identyfikator można używać w innych interfejsach API, które akceptują identyfikatory miejsc.
secondaryText
Typ:  FormattableText optional
Zawiera dodatkowe cechy rozróżniające (np. miasto lub region), które pozwalają dokładniej zidentyfikować miejsce.
text
Zawiera czytelną dla człowieka nazwę zwróconego wyniku. W przypadku wyników dotyczących placówek jest to zwykle nazwa i adres firmy.

text jest zalecany dla deweloperów, 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ć elementów PlacePrediction.mainText i PlacePrediction.secondaryText.
types
Typ:  Array<string>
Lista typów, które odnoszą się do 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
Zwracana wartość:  Place
Zwraca reprezentację miejsca w tym obiekcie PlacePrediction. Aby uzyskać pełne informacje o miejscu, musisz wykonać kolejne połączenie z Place.fetchFields.

StringRange class

google.maps.places.StringRange zajęcia

Określa podciąg w danym tekście.

Dostęp przez połączenie pod numer const {StringRange} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
endOffset
Typ:  number
Indeks ostatniego znaku Unicode w podciągu (liczony od zera, wyłączony).
startOffset
Typ:  number
Indeks pierwszego znaku Unicode w podłańcuchu (włącznie), liczony od zera.

Klasa FormattableText

google.maps.places.FormattableText zajęcia

Tekst reprezentujący prognozę miejsca. Tekst może być używany w niezmienionej postaci lub sformatowany.

Dostęp przez połączenie pod numer const {FormattableText} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
matches
Lista zakresów ciągów tekstowych określających, gdzie w FormattableText.text wystąpiło dopasowanie żądania wejściowego. Zakresy można stosować do formatowania określonych części 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ągów znaków (np. korekty pisowni lub transliteracji). Te wartości to przesunięcia znaków Unicode względem znaku FormattableText.text. Zakresy są uporządkowane według rosnących wartości przesunięcia.
text
Typ:  string
Tekst, którego można użyć w niezmienionej formie lub sformatować za pomocą FormattableText.matches.