Autocomplete Data (new)

interfejs AutocompleteRequest

Interfejs google.maps.places.AutocompleteRequest

Interfejs żądania AutocompleteSuggestion.fetchAutocompleteSuggestions.

Właściwości
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.

Zespół
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.

Metody statyczne
fetchAutocompleteSuggestions	fetchAutocompleteSuggestions(autocompleteRequest) Parametry:  autocompleteRequest:  AutocompleteRequest Zwracana wartość:  Promise<{suggestions:Array<AutocompleteSuggestion>}> Pobiera listę sugestii autouzupełniania.

Właściwości
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.

Właściwości
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	Typ:  FormattableText 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.

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

Właściwości
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.

Właściwości
matches	Typ:  Array<StringRange> 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.