Autocomplete Data

Klasa AutocompleteSuggestion

google.maps.places.AutocompleteSuggestion klasa
biblioteka "places"

Wynik sugestii autouzupełniania.

const {AutocompleteSuggestion} = await google.maps.importLibrary("places");

Metody statyczne

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) Parametry: autocompleteRequest: AutocompleteRequest Wartość zwracana: Promise<{suggestions:Array<AutocompleteSuggestion>}> Pobiera listę sugestii autouzupełniania. Jeśli w żądaniu podano AutocompleteRequest.sessionToken, ten token sesji zostanie automatycznie uwzględniony podczas pierwszego wywołania Place.fetchFields w każdym Place zwróconym przez PlacePrediction.toPlace w wynikowych PlacePrediction.

Właściwości

placePrediction readonly

Typ: PlacePrediction optional Zawiera zrozumiałą dla człowieka nazwę zwróconego wyniku. W przypadku wyników dotyczących placówek są to zwykle nazwa i adres firmy. Jeśli w żądaniu AutocompleteRequest użytym do pobrania tej sugestii AutocompleteSuggestion podano token AutocompleteRequest.sessionToken, ten sam token zostanie automatycznie uwzględniony przy pierwszym wywołaniu metody Place.fetchFields w obiekcie Place zwróconym przez wywołanie metody PlacePrediction.toPlace.

Interfejs AutocompleteRequest

Interfejs google.maps.places.AutocompleteRequest

Interfejs żądania dla: AutocompleteSuggestion.fetchAutocompleteSuggestions.

Właściwości
input	Typ: string Ciąg tekstowy, który ma zostać wyszukany.
futureOpeningBusinessesIncluded opcjonalne	Typ: boolean optional Uwzględnij podpowiedzi miejsc dla firm, które nie są jeszcze otwarte, ale mają zostać otwarte w przyszłości.
includedPrimaryTypes opcjonalne	Typ: Array<string> optional Uwzględniony główny typ miejsca (np. „restauracja” lub „stacja_paliw”). 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 są wszystkie typy miejsc.
includedRegionCodes opcjonalne	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 ustawione są zarówno locationRestriction, jak i includedRegionCodes, wyniki będą znajdować się w obszarze przecięcia.
inputOffset opcjonalne	Typ: number optional Przesunięcie znaku Unicode od 0 o wartości input, które wskazuje pozycję kursora w input. Pozycja kursora może wpływać na zwracane podpowiedzi. Jeśli nie podasz tu żadnej wartości, zostanie użyta domyślna długość input.
language opcjonalne	Typ: string optional Język, w którym mają być zwracane wyniki. Domyślnie zostanie zastosowane ustawienie języka przeglądarki. Wyniki mogą być w różnych językach, jeśli język używany w input różni się od language lub jeśli zwrócone miejsce nie ma tłumaczenia z języka lokalnego na language.
locationBias opcjonalne	Typ: LocationBias optional Wyniki są dostosowywane do określonej lokalizacji. Można ustawić maksymalnie jedną z tych właściwości: locationBias lub locationRestriction. Jeśli nie ustawisz żadnej z tych wartości, wyniki będą dostosowywane na podstawie adresu IP, co oznacza, że adres IP zostanie zmapowany na niedokładną lokalizację i użyty jako sygnał do dostosowywania.
locationRestriction opcjonalne	Typ: LocationRestriction optional Ogranicz wyniki do określonej lokalizacji. Można ustawić maksymalnie jedną z tych właściwości: locationBias lub locationRestriction. Jeśli nie ustawisz żadnej z tych wartości, wyniki będą dostosowywane na podstawie adresu IP, co oznacza, że adres IP zostanie zmapowany na niedokładną lokalizację i użyty jako sygnał do dostosowywania.
origin opcjonalne	Typ: LatLng|LatLngLiteral optional Punkt początkowy, od którego ma być obliczana odległość geodezyjna do miejsca docelowego (zwracana jako PlacePrediction.distanceMeters). Jeśli ta wartość zostanie pominięta, odległość geodezyjna nie zostanie zwrócona.
pureServiceAreaBusinessesIncluded opcjonalne	Typ: boolean optional Jeśli pole ma wartość „true”, uwzględniaj firmy działające wyłącznie na określonym obszarze. Firma działająca wyłącznie na określonym obszarze to firma, która świadczy usługi na miejscu u klienta lub samodzielnie dostarcza produkty odbiorcom, ale nie obsługuje klientów pod swoim adresem. Na przykład firmy świadczące usługi sprzątania lub hydraulicy mogą nie mieć adresu fizycznego ani lokalizacji w Mapach Google.
region opcjonalne	Typ: string optional Kod regionu określony jako dwuznakowy kod regionu CLDR. Wpływa to na formatowanie adresu, ranking wyników i może mieć wpływ na zwracane wyniki. Nie ogranicza to wyników do określonego regionu.
sessionToken opcjonalne	Typ: AutocompleteSessionToken optional Token, który identyfikuje sesję autouzupełniania do celów rozliczeniowych. Wygeneruj nowy token sesji za pomocą AutocompleteSessionToken. Sesja rozpoczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy, gdy wybierze miejsce i wywoła metodę Place.fetchFields. Każda sesja może zawierać wiele zapytań, po których następuje jedno wywołanie fetchFields. Dane logowania używane w przypadku każdego żądania w sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli parametr sessionToken zostanie pominięty lub jeśli użyjesz ponownie tokena sesji, sesja zostanie rozliczona tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno). Gdy w żądaniu do AutocompleteSuggestion.fetchAutocompleteSuggestions podany jest token sesji, ten sam token zostanie automatycznie uwzględniony w pierwszym wywołaniu metody fetchFields w obiekcie Place zwróconym przez wywołanie metody PlacePrediction.toPlace w jednym z wynikowych obiektów AutocompleteSuggestion. Zalecamy stosowanie się do tych wytycznych: Używaj tokenów sesji we wszystkich wywołaniach autouzupełniania miejsc. Generuj nowy token dla każdej sesji. Pamiętaj, aby przekazywać unikalny token sesji dla każdej nowej sesji. Użycie tego samego tokena w więcej niż 1 sesji spowoduje, że każde żądanie będzie rozliczane osobno.

Klasa AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken klasa
biblioteka "places"

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

const {AutocompleteSessionToken} = await google.maps.importLibrary("places");

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

Klasa PlacePrediction

google.maps.places.PlacePrediction klasa
biblioteka "places"

Wyniki podpowiedzi autouzupełniania miejsc.

const {PlacePrediction} = await google.maps.importLibrary("places");

Właściwości
distanceMeters readonly	Typ: number optional Długość linii geodezyjnej w metrach od origin, jeśli określono origin.
mainText readonly	Typ: FormattableText optional Reprezentuje nazwę miejsca.
placeId readonly	Typ: string Unikalny identyfikator sugerowanego miejsca. Można go używać w innych interfejsach API, które akceptują identyfikatory miejsc.
secondaryText readonly	Typ: FormattableText optional Reprezentuje dodatkowe cechy uściślające (takie jak miasto lub region), które ułatwiają identyfikację miejsca.
text readonly	Typ: FormattableText Zawiera zrozumiałą dla człowieka nazwę zwróconego wyniku. W przypadku wyników dotyczących placówek 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ą wyświetlać 2 osobne, ale powiązane elementy interfejsu, mogą zamiast tego użyć PlacePrediction.mainText i PlacePrediction.secondaryText.
types readonly	Typ: Array<string> Lista typów, które mają zastosowanie do tego miejsca, z tabeli A lub B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.

Metody
fetchAddressValidation	Uwaga: ta funkcja jest dostępna tylko w wersji beta. fetchAddressValidation(request) Parametry: request: AddressValidationRequest Wartość zwracana: 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 PlacePrediction nie są uwzględniane automatycznie – jest to metoda ułatwiająca zarządzanie sesją autouzupełniania.
toPlace	toPlace() Parametry: brak Wartość zwracana: Place Zwraca reprezentację Place tego obiektu PlacePrediction. Aby uzyskać pełne informacje o miejscu, musisz wykonać kolejne wywołanie metody Place.fetchFields. Jeśli w parametrze AutocompleteRequest użytym do pobrania tego obiektu PlacePrediction podano parametr AutocompleteRequest.sessionToken, ten sam token zostanie automatycznie uwzględniony podczas wywoływania metody fetchFields. Możesz też użyć PlaceAutocompleteElement, aby pierwsze wywołanie Place.fetchFields w Place zwróconym przez PlacePrediction.toPlace automatycznie zawierało token sesji.

Klasa StringRange

google.maps.places.StringRange klasa
biblioteka "places"

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

const {StringRange} = await google.maps.importLibrary("places");

Właściwości
endOffset readonly	Typ: number Przesunięcie od zera ostatniego znaku Unicode podłańcucha (wykluczając najwyższą wartość).
startOffset readonly	Typ: number Przesunięcie pierwszego znaku Unicode podłańcucha (włącznie) liczone od zera.

Klasa FormattableText

google.maps.places.FormattableText klasa
biblioteka "places"

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

const {FormattableText} = await google.maps.importLibrary("places");

Właściwości
matches readonly	Typ: Array<StringRange> Lista zakresów ciągów tekstowych określających, gdzie żądanie wejściowe zostało dopasowane w usłudze FormattableText.text. Zakresy mogą służyć do formatowania określonych części elementu text. Podłańcuchy mogą nie być dokładnymi dopasowaniami do AutocompleteRequest.input, jeśli dopasowanie zostało określone na podstawie kryteriów innych niż dopasowanie ścisłe (np. korekty pisowni lub transliteracje). Te wartości to przesunięcia znaków Unicode w FormattableText.text. Zakresy są uporządkowane według rosnących wartości przesunięcia.
text readonly	Typ: string Tekst, który może być używany w niezmienionej postaci lub sformatowany za pomocą FormattableText.matches.