Autocomplete Data (new)

interfejs AutocompleteRequest

Interfejs google.maps.places.AutocompleteRequest

Interfejs żądania AutocompleteSuggestion.fetchAutocompleteSuggestions.
input
Typ:  string
Ciąg tekstowy, który ma być przeszukiwany.
includedPrimaryTypes optional
Typ:  Array<string> optional
Uwzględnione podstawowe typ miejsca (np. „restauracja” lub „stacja benzynowa”).

Miejsce jest zwracane tylko wtedy, gdy jego główny typ znajduje się na tej liście. Można określić maksymalnie 5 wartości. Jeśli nie podasz żadnych typów, zwrócone zostaną wszystkie typy miejsc.
includedRegionCodes optional
Typ:  Array<string> optional
Uwzględnij tylko wyniki z określonych regionów (maksymalnie 15 dwuznakowych kodów regionów CLDR). Pusty zestaw nie ogranicza wyników. Jeśli są ustawione zarówno locationRestriction, jak i includedRegionCodes, wyniki będą znajdować się na obszarze skrzyżowania.
inputOffset optional
Typ:  number optional
Odsunięcie znaków Unicode input od zera, które wskazuje pozycję kursora w polu input. Pozycja kursora może wpływać na wyświetlane podpowiedzi. Jeśli nie podasz tu żadnej wartości, domyślnie zostanie użyta długość input.
language optional
Typ:  string optional
Język, w którym mają być zwracane wyniki. Domyślnie będzie to język wybrany w przeglądarce. Wyniki mogą być w różnych językach, jeśli język używany w języku input jest inny niż language lub jeśli zwrócone miejsce nie ma tłumaczenia z języka lokalnego na language.
locationBias optional
Typ:  LocationBias optional
Odchylenie wyników do określonej lokalizacji.

Należy ustawić maksymalnie jedną z tych wartości: locationBias lub locationRestriction. Jeśli nie ustawisz żadnej, wyniki będą zniekształcane ze względu na adres IP, co oznacza, że zostanie on zmapowany na nieprecyzyjną lokalizację i będzie używany jako sygnał promowania.
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 nie ustawisz żadnej, wyniki będą zniekształcane ze względu na adres IP, co oznacza, że zostanie on zmapowany na nieprecyzyjną lokalizację i będzie używany jako sygnał promowania.
origin optional
Typ:  LatLng|LatLngLiteral optional
Punkt początkowy, z którego oblicza się 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 oraz na wyświetlane wyniki. Nie ogranicza to wyników do określonego regionu.
sessionToken optional
Typ:  AutocompleteSessionToken optional
Token, który identyfikuje sesję autouzupełniania w celach rozliczeniowych. Wygeneruj nowy token sesji w AutocompleteSessionToken.

Sesja rozpoczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy się, gdy wybierze miejsce i wywoła metodę Place.fetchFields. Każda sesja może zawierać wiele zapytań, a następnie jedno wywołanie fetchFields. Dane logowania używane w każdym żądaniu w sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token straci ważność – aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli parametr sessionToken zostanie pominięty lub użyjesz tokena sesji ponownie, sesja jest obciążana tak, jakby żaden token sesji nie został udostępniony (każde żądanie jest rozliczane oddzielnie).

Zalecamy zastosowanie się do tych wskazówek:
  • Używaj tokenów sesji dla wszystkich wywołań autouzupełniania miejsc.
  • Wygeneruj nowy token dla każdej sesji.
  • Pamiętaj, aby w przypadku każdej nowej sesji przekazać unikalny token sesji. Jeśli użyjesz tego samego tokena w więcej niż 1 sesji, każde żądanie zostanie rozliczone osobno.

Klasa AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken zajęcia

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

Uzyskaj dostęp, dzwoniąc pod numer const {AutocompleteSessionToken} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
AutocompleteSessionToken
AutocompleteSessionToken()
Parametry: brak
Tworzy nową instancję instancji AutocompleteSessionToken.

klasa AutocompleteSuggestion.

google.maps.places.AutocompleteSuggestion zajęcia

Wynik sugestii autouzupełniania.

Uzyskaj dostęp, dzwoniąc pod numer const {AutocompleteSuggestion} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Parametry: 
Zwracana wartość:  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 wyszukiwania są to zwykle nazwa i adres firmy.

Klasa PlacePrediction

google.maps.places.PlacePrediction zajęcia

Wyniki prognozowania dla podpowiedzi autouzupełniania miejsca.

Uzyskaj dostęp, dzwoniąc pod numer const {PlacePrediction} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
distanceMeters
Typ:  number optional
Długość geodezji w metrach od origin, jeśli określono origin.
mainText
Typ:  FormattableText optional
Reprezentuje nazwę miejsca.
placeId
Typ:  string
Unikalny identyfikator sugerowanego miejsca. Ten identyfikator może być używany w innych interfejsach API, które akceptują identyfikatory miejsc.
secondaryText
Typ:  FormattableText optional
Reprezentuje dodatkowe cechy wyróżniające (np. miasto lub region) w celu lepszej identyfikacji miejsca.
text
Zawiera czytelną dla człowieka nazwę zwróconego wyniku. W przypadku wyników wyszukiwania są to zwykle nazwa i adres firmy.

text jest zalecany dla deweloperów, którzy chcą wyświetlać pojedynczy element interfejsu. Deweloperzy, którzy chcą pokazać 2 osobne, ale powiązane elementy interfejsu, mogą zamiast tego użyć elementów PlacePrediction.mainText i PlacePrediction.secondaryText.
types
Typ:  Array<string>
Lista typów dotyczących tego miejsca z tabeli A lub B tabeli https://developers.google.com/maps/documentation/places/web-service/place-types.
toPlace
toPlace()
Parametry: brak
Zwracana wartość:  Place
Zwraca reprezentację tej prognozy miejsca. Aby uzyskać pełne informacje o miejscu, wymagane jest kolejne wywołanie pod numerem Place.fetchFields.

klasa StringRange

google.maps.places.StringRange zajęcia

Identyfikuje podłańcuch w danym tekście.

Uzyskaj dostęp, dzwoniąc pod numer const {StringRange} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
endOffset
Typ:  number
Przesunięcie od zera ostatniego znaku Unicode podłańcucha (z wyłączeniem).
startOffset
Typ:  number
Przesunięcie pierwszego znaku Unicode podłańcucha (włącznie) od zera.

klasa FormattableText

google.maps.places.FormattableText zajęcia

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

Uzyskaj dostęp, dzwoniąc pod numer const {FormattableText} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
matches
Lista zakresów ciągów wskazujących, w którym miejscu FormattableText.text zostało dopasowane żądanie wejściowe. Za pomocą zakresów można sformatować określone części obiektu text. Podłańcuchy mogą nie być dokładne zgodne z parametrem AutocompleteRequest.input, jeśli dopasowanie zostało określone na podstawie innych kryteriów niż dopasowanie ciągów znaków (na przykład przez korektę pisowni lub transliterację). Te wartości to przesunięcia znaków w zestawie Unicode FormattableText.text. Zakresy będą uporządkowane w coraz większej wartości przesunięcia.
text
Typ:  string
Tekst, którego można używać w takiej postaci lub w formacie FormattableText.matches.