Autocomplete Data (new)

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.

Metody statyczne

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) Parametry:  autocompleteRequest:  AutocompleteRequest Zwracana wartość:  Promise<{suggestions:Array<AutocompleteSuggestion>}> Pobiera listę AutocompleteSuggestions. Jeśli w żądaniu podano AutocompleteRequest.sessionToken, token sesji zostanie automatycznie uwzględniony podczas pierwszego wywołania Place.fetchFields w przypadku każdego Place zwróconego przez PlacePrediction.toPlace w wynikowych PlacePrediction.

Właściwości

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. Jeśli w obiekcie AutocompleteRequest używanym do pobierania tego obiektu AutocompleteSuggestion podano AutocompleteRequest.sessionToken, ten sam token zostanie automatycznie uwzględniony podczas pierwszego wywołania funkcji Place.fetchFields na obiekcie Place zwróconym przez wywołanie funkcji PlacePrediction.toPlace.

Interfejs AutocompleteRequest

google.maps.places.AutocompleteRequestinterfejs

Interfejs żądania dla AutocompleteSuggestion.fetchAutocompleteSuggestions.

Właściwości
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). Gdy w żądaniu wysłanym do AutocompleteSuggestion.fetchAutocompleteSuggestions podany jest token sesji, ten sam token zostanie automatycznie uwzględniony w pierwszym wywołaniu funkcji fetchFields na obiekcie Place zwróconym przez wywołanie funkcji PlacePrediction.toPlace na jednym z obiektów AutocompleteSuggestion. 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.

Zespół
AutocompleteSessionToken	AutocompleteSessionToken() Parametry: brak Tworzy nową instancję AutocompleteSessionToken.

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.

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

Metody
fetchAddressValidation	Uwaga: dostępna tylko na kanale v=beta. fetchAddressValidation(request) Parametry:  request:  AddressValidationRequest Zwracana wartość:  Promise<AddressValidation> Wysyła żądanie weryfikacji adresu powiązane z tą sesją autouzupełniania (wewnętrznie wypełniając żądanie tokenem sesji autouzupełniania). Żadne informacje o miejscu z obiektu PlacePrediction nie są uwzględniane automatycznie. Jest to wygodna metoda ułatwiająca zarządzanie sesją autouzupełniania.
toPlace	toPlace() Parametry: brak Zwracana wartość:  Place Zwraca reprezentację Place tego obiektu PlacePrediction. Aby uzyskać pełne informacje o miejscu, musisz wykonać kolejne połączenie z Place.fetchFields.  Jeśli w AutocompleteRequest używanym do pobierania tego obiektu PlacePrediction podano AutocompleteRequest.sessionToken, ten sam token zostanie automatycznie uwzględniony podczas wywoływania funkcji fetchFields.  Możesz też użyć PlaceAutocompleteElement. Pierwsze połączenie z Place.fetchFields na Place zwróconym przez PlacePrediction.toPlace będzie automatycznie zawierać token sesji.

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.

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

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