Places Widgets

Klasa PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement zajęcia

PlaceAutocompleteElement to podklasa HTMLElement, która stanowi komponent interfejsu dla interfejsu Places Autocomplete API.

Element niestandardowy:
<gmp-place-autocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-place-autocomplete>

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: 
componentRestrictions
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
Typ:  LocationBias optional
Delikatna granica lub wskazówka do wykorzystania podczas wyszukiwania miejsc.
locationRestriction
Typ:  LocationRestriction optional
Ograniczenia nakładania wyników wyszukiwania.
name
Typ:  string optional
Nazwa, która ma być używana dla elementu wejściowego. Szczegółowe informacje znajdziesz na stronie https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. Działa tak samo jak atrybut name w przypadku danych wejściowych. Ta nazwa będzie używana podczas przesyłania formularza. Szczegółowe informacje znajdziesz na stronie https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Atrybut HTML:
  • <gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage
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.
Atrybut HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
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”).
Atrybut HTML:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
types
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.
Atrybut HTML:
  • <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>
prediction-item
Element w menu, który reprezentuje pojedynczą prognozę.
prediction-item-icon
Ikona wyświetlana po lewej stronie każdej pozycji na liście prognoz.
prediction-item-main-text
Część elementu prognozy, która jest głównym tekstem prognozy. W przypadku lokalizacji geograficznej zawiera nazwę miejsca, np. „Gdańsk”, lub nazwę i numer ulicy, np. „ul. Główna 10”. Domyślnie tekst główny elementu prognozy ma kolor czarny. Jeśli w elemencie prognozy znajduje się dodatkowy tekst, znajduje się on poza obiektem prognozowania_elementu-głównego i dziedziczy jego styl z elementu prognozy. Domyślnym kolorem jest on szary. Dodatkowy tekst to zwykle adres.
prediction-item-match
Część zwróconej prognozy, która pasuje do danych wejściowych użytkownika. Ten dopasowany tekst jest domyślnie pogrubiony. Pamiętaj, że dopasowany tekst może znajdować się w dowolnym miejscu elementu prognozy. Nie musi być częścią tekstu głównego elementu prognozy.
prediction-item-selected
Element, gdy użytkownik przejdzie do niego za pomocą klawiatury. Uwaga: na wybrane elementy będą miały wpływ zarówno te style części, jak i style części elementu prognozy.
prediction-list
Element wizualny zawierający listę podpowiedzi zwracanych przez usługę autouzupełniania miejsc. Pojawia się ona jako lista pod elementem PlaceAutocompleteElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków reprezentujący typ nasłuchiwanego zdarzenia (z rozróżnianiem wielkości liter).
  • listenerEventListener|EventListenerObject obiekt, który otrzymuje powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|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: 
  • typestring ciąg tekstowy określający typ zdarzenia, z którego ma zostać usunięty detektor zdarzeń.
  • listenerEventListener|EventListenerObject detektor modułu obsługi zdarzeń, który ma zostać usunięty z celu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Wartość zwrotu:  void
Usuwa z celu detektor zdarzeń zarejestrowany wcześniej w addEventListener. Zobacz removeEventListener.
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
Argumenty: 
Zdarzenie to jest wywoływane, gdy użytkownik wybierze prognozę miejsca. Zawiera obiekt Place.
gmp-requesterror
function(placeAutocompleteRequestErrorEvent)
Argumenty: 
Zdarzenie to jest wywoływane, gdy żądanie wysłane do backendu zostanie odrzucone (np. nieprawidłowy klucz interfejsu API). To wydarzenie nie wyświetla się jako dymki.

Interfejs PlaceAutocompleteElementOptions

google.maps.places.PlaceAutocompleteElementOptions interfejs

Opcje tworzenia elementu PlaceAutocompleteElement.

componentRestrictions optional
Typ:  ComponentRestrictions optional
locationBias optional
Typ:  LocationBias optional
locationRestriction optional
Typ:  LocationRestriction optional
requestedLanguage optional
Typ:  string optional
requestedRegion optional
Typ:  string optional
types optional
Typ:  Array<string> optional

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.

Betaplace
Typ:  Place

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: 
  • fieldsArray<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: 
  • typesArray<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.