Places Widgets

Klasa PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement zajęcia

  • PlaceAutocompleteElement to podklasa HTMLElement, która stanowi komponent interfejsu dla interfejsu Places Autocomplete API. Po wczytaniu biblioteki places możesz utworzyć w kodzie HTML dane wejściowe z funkcją autouzupełniania. Przykład: 
    <gmp-placeautocomplete ></gmp-placeautocomplete>

Element niestandardowy:
<gmp-placeautocomplete></gmp-placeautocomplete>

Te zajęcia są rozszerzone na HTMLElement.

Ta klasa implementuje PlaceAutocompleteElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceAutocompleteElement} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parametry: 
inputElement
Element wejściowych, dla którego wyświetlane są pozycje autouzupełniania.
Dziedziczone: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków reprezentujący typ nasłuchiwanego zdarzenia (z rozróżnianiem wielkości liter).
  • listener:  EventListener|EventListenerObject obiekt, który otrzymuje powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • options:  boolean|AddEventListenerOptions optional Zobacz opcje. Zdarzenia niestandardowe obsługują tylko zdarzenia capture i passive.
Wartość zwrotu:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do środowiska docelowego. Zobacz addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg tekstowy określający typ zdarzenia, z którego ma zostać usunięty detektor zdarzeń.
  • listener:  EventListener|EventListenerObject detektor modułu obsługi zdarzeń, który ma zostać usunięty z celu zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje
Wartość zwrotu:  void
Usuwa z celu detektor zdarzeń zarejestrowany wcześniej w addEventListener. Zobacz removeEventListener.

Interfejs PlaceAutocompleteElementOptions

google.maps.places.PlaceAutocompleteElementOptions interfejs

Opcje tworzenia elementu PlaceAutocompleteElement.
inputElement
Element wejściowych, dla którego wyświetlane są pozycje autouzupełniania.
componentRestrictions optional
Typ:  ComponentRestrictions optional
Ograniczenia komponentów. Ograniczenia dotyczące komponentów umożliwiają ograniczenie prognoz tylko do tych, które znajdują się w komponencie nadrzędnym. Może to być na przykład kraj.
locationBias optional
Typ:  LocationBias optional
Delikatna granica lub wskazówka do wykorzystania podczas wyszukiwania miejsc.
locationRestriction optional
Typ:  LocationRestriction optional
Ograniczenia nakładania wyników wyszukiwania.
requestedLanguage optional
Typ:  string optional
Identyfikator języka, w którym powinny być zwracane wyniki, jeśli to możliwe. Wyniki w wybranym języku mogą mieć wyższą pozycję w rankingu, ale sugestie nie są ograniczone do tego języka. Zobacz listę obsługiwanych języków.
requestedRegion optional
Typ:  string optional
Kod regionu, który służy do formatowania i filtrowania wyników. Nie ogranicza ona sugestii do tego kraju. Kod regionu akceptuje dwuznaczną wartość ccTLD („domena najwyższego poziomu”). Większość kodów domen ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład domena ccTLD w Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie oznacza to „Wielka Brytania i Irlandia Północna”).
types optional
Typ:  Array<string> optional
Typy prognoz, które mają zostać zwrócone. Listę obsługiwanych typów znajdziesz w przewodniku dla programistów. Jeśli nie podasz żadnych typów, zwrócone zostaną wszystkie typy.

Klasa PlaceAutocompletePlaceSelectEvent

google.maps.places.PlaceAutocompletePlaceSelectEvent zajęcia

Zdarzenie to jest tworzone po wybraniu przez użytkownika miejsca z elementem autouzupełniania miejsca. Aby uzyskać dostęp do wybranych elementów, kliknij event.place.

Te zajęcia są rozszerzone na Event.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Klasa PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent zajęcia

To zdarzenie jest wywoływane przez element PlaceAutocompleteElement w przypadku wystąpienia problemu z żądaniem sieciowym.

Te zajęcia są rozszerzone na Event.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

Autouzupełnianie

google.maps.places.Autocomplete zajęcia

Widżet, który wyświetla przewidywane miejsca na podstawie tekstu wprowadzonego przez użytkownika. Dołącza się do elementu wejściowego typu text i nasłuchuje tekstu w tym polu. Lista prognoz ma postać rozwijaną i aktualizowana w miarę wpisywania tekstu.

Te zajęcia są rozszerzone na MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer const {Autocomplete} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
Autocomplete
Autocomplete(inputField[, opts])
Parametry: 
Tworzy nowe wystąpienie obiektu Autocomplete, które dołącza do określonego pola tekstowego wejściowego z podanymi opcjami.
getBounds
getBounds()
Parametry: brak
Zwracana wartość:  LatLngBounds|undefined progi odchylenia.
Zwraca granice, do których prawdopodobieństwo jest stronne.
getFields
getFields()
Parametry: brak
Wartość zwrotu:  Array<string>|undefined
Zwraca pola, które mają zostać uwzględnione w odpowiedzi dotyczącej miejsca w odpowiedzi szczegółów po pobraniu informacji. Listę pól znajdziesz na stronie PlaceResult.
getPlace
getPlace()
Parametry: brak
Zwracana wartość:  PlaceResult miejsce wybrane przez użytkownika.
Zwraca szczegółowe informacje o miejscu wybranym przez użytkownika, jeśli szczegóły zostały pomyślnie pobrane. W przeciwnym razie zwraca obiekt typu Place z właściwością name ustawioną na bieżącą wartość pola do wprowadzania danych.
setBounds
setBounds(bounds)
Parametry: 
Zwracana wartość: brak
Ustawia preferowany obszar, z którego mają być zwracane wyniki wyszukiwania miejsc. Wyniki są stronnicze i dotyczą tego obszaru, ale nie tylko.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parametry: 
Zwracana wartość: brak
Określa ograniczenia komponentów. Ograniczenia dotyczące komponentów umożliwiają ograniczenie prognoz tylko do tych, które znajdują się w komponencie nadrzędnym. Może to być na przykład kraj.
setFields
setFields(fields)
Parametry: 
  • fields:  Array<string> optional
Zwracana wartość: brak
Ustawia pola, które mają być uwzględnione w odpowiedzi dotyczącej miejsca w odpowiedzi szczegółów po pomyślnym pobraniu szczegółów. Listę pól znajdziesz na stronie PlaceResult.
setOptions
setOptions(options)
Parametry: 
Zwracana wartość: brak
setTypes
setTypes(types)
Parametry: 
  • types:  Array<string> optional typy prognoz, które mają zostać uwzględnione.
Zwracana wartość: brak
Określa typy prognoz, które mają być zwracane. Listę obsługiwanych typów znajdziesz w przewodniku dla programistów. Jeśli nie podasz żadnych typów, zwrócone zostaną wszystkie typy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argumenty: brak
Zdarzenie to jest wywoływane, gdy dla miejsca wybranego przez użytkownika zostanie udostępniony PlaceResult.
Jeśli użytkownik wpisze nazwę miejsca, która nie została zaproponowana przez element sterujący i naciśnie klawisz Enter, lub jeśli żądanie informacji o miejscu nie powiedzie się, PlaceResult będzie zawierać dane wejściowe użytkownika we właściwości name, bez zdefiniowanych innych właściwości.

Interfejs AutocompleteOptions

google.maps.places.AutocompleteOptions interfejs

Opcje, które można ustawić w obiekcie Autocomplete.
bounds optional
Obszar, w którym wyszukiwane są miejsca.
componentRestrictions optional
Typ:  ComponentRestrictions optional
Ograniczenia komponentów. Ograniczenia dotyczące komponentów umożliwiają ograniczenie prognoz tylko do tych, które znajdują się w komponencie nadrzędnym. Może to być na przykład kraj.
fields optional
Typ:  Array<string> optional
Pola, które mają zostać uwzględnione w odpowiedzi ze szczegółami po pobraniu danych, za które zostanie naliczona opłata. Jeśli przekażesz pole ['ALL'], wszystkie dostępne pola zostaną zwrócone i zapłacone (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult. Zagnieżdżone pola można określać za pomocą ścieżek punktowych (na przykład "geometry.location"). Wartość domyślna to ['ALL'].
placeIdOnly optional
Typ:  boolean optional
Określa, czy pobrać tylko identyfikatory miejsc. Element PlaceResult dostępny po wywołaniu zdarzenia place_changed będzie zawierał tylko identyfikator Place_id, typy i name oraz identyfikator miejsca, typy i opis zwracane przez usługę autouzupełniania. Domyślnie ta opcja jest wyłączona.
strictBounds optional
Typ:  boolean optional
Wartość logiczna wskazująca, że widżet autouzupełniania powinien zwracać tylko te miejsca, które znajdują się w jego granicach podczas wysyłania zapytania. Ustawienie wartości strictBounds na false (ustawienie domyślne) spowoduje, że wyniki będą odchylane do miejsc w granicach, lecz nie do nich.
types optional
Typ:  Array<string> optional
Typy prognoz, które mają zostać zwrócone. Listę obsługiwanych typów znajdziesz w przewodniku dla programistów. Jeśli nie podasz żadnych typów, zwrócone zostaną wszystkie typy.

google.maps.places.SearchBox zajęcia

Widżet, który dostarcza prognozy zapytań na podstawie wpisanego przez użytkownika tekstu. Dołącza się do elementu wejściowego typu text i nasłuchuje tekstu w tym polu. Lista prognoz ma postać rozwijaną i aktualizowana w miarę wpisywania tekstu.

Te zajęcia są rozszerzone na MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer const {SearchBox} = await google.maps.importLibrary("places"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
SearchBox
SearchBox(inputField[, opts])
Parametry: 
Tworzy nowe wystąpienie obiektu SearchBox, które dołącza do określonego pola tekstowego wejściowego z podanymi opcjami.
getBounds
getBounds()
Parametry: brak
Wartość zwrotu:  LatLngBounds|undefined
Zwraca granice, do których uzależnione są prognozy zapytań.
getPlaces
getPlaces()
Parametry: brak
Wartość zwrotu:  Array<PlaceResult>|undefined
Zwraca zapytanie wybrane przez użytkownika, które ma zostać użyte ze zdarzeniem places_changed.
setBounds
setBounds(bounds)
Parametry: 
Zwracana wartość: brak
Ustawia region, który ma być używany do promowania prognoz zapytań. Wyniki będą odnosić się wyłącznie do tego obszaru i nie będą ograniczone do niego.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane, gdy użytkownik wybiera zapytanie. Do uzyskania nowych miejsc należy użyć parametru getPlaces.

Interfejs SearchBoxOptions

google.maps.places.SearchBoxOptions interfejs

Opcje, które można ustawić w obiekcie SearchBox.
bounds optional
Obszar, na który mają być ukierunkowane prognozy zapytań. Prognozy ukierunkowują zapytania kierowane na te wartości progowe, lecz nie tylko.