Places Widgets

Klasa PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement zajęcia

Uwaga: ta funkcja jest dostępna tylko w kanale v=beta.

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.

Zespół
PlaceAutocompleteElement	PlaceAutocompleteElement(options) Parametry:  options:  PlaceAutocompleteElementOptions

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

Części
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.

Metody
addEventListener	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. 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.
removeEventListener	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. 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.

Wydarzenia
gmp-placeselect	function(placeAutocompletePlaceSelectEvent) Argumenty:  placeAutocompletePlaceSelectEvent:  PlaceAutocompletePlaceSelectEvent Zdarzenie to jest wywoływane, gdy użytkownik wybierze prognozę miejsca. Zawiera obiekt Place.
gmp-requesterror	function(placeAutocompleteRequestErrorEvent) Argumenty:  placeAutocompleteRequestErrorEvent:  PlaceAutocompleteRequestErrorEvent 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

Uwaga: ta funkcja jest dostępna tylko w kanale v=beta.

Opcje tworzenia elementu PlaceAutocompleteElement.

Właściwości
componentRestrictions optional	Typ:  ComponentRestrictions optional Zobacz: PlaceAutocompleteElement.componentRestrictions
locationBias optional	Typ:  LocationBias optional Zobacz: PlaceAutocompleteElement.locationBias
locationRestriction optional	Typ:  LocationRestriction optional Zobacz: PlaceAutocompleteElement.locationRestriction
requestedLanguage optional	Typ:  string optional Zobacz: PlaceAutocompleteElement.requestedLanguage
requestedRegion optional	Typ:  string optional Zobacz: PlaceAutocompleteElement.requestedRegion
types optional	Typ:  Array<string> optional Zobacz: PlaceAutocompleteElement.types

Klasa PlaceAutocompletePlaceSelectEvent

google.maps.places.PlaceAutocompletePlaceSelectEvent zajęcia

Uwaga: ta funkcja jest dostępna tylko w kanale v=beta.

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.

Właściwości
place	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. Typ:  Place

Klasa PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent zajęcia

Uwaga: ta funkcja jest dostępna tylko w kanale v=beta.

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.

Zespół
Autocomplete	Autocomplete(inputField[, opts]) Parametry:  inputField:  HTMLInputElement pole tekstowe <input>, do którego należy dołączyć Autocomplete. opts:  AutocompleteOptions optional Opcje. Tworzy nowe wystąpienie obiektu Autocomplete, które dołącza do określonego pola tekstowego wejściowego z podanymi opcjami.

Metody
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:  bounds:  LatLngBounds|LatLngBoundsLiteral optional progi odchylenia. 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:  restrictions:  ComponentRestrictions optional ograniczenia stosowania. 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:  options:  AutocompleteOptions optional 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

Wydarzenia

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.

Właściwości
bounds optional	Typ:  LatLngBounds|LatLngBoundsLiteral 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	Wycofane: usługa placeIdOnly została wycofana 15 stycznia 2019 r. i wyłączona 15 stycznia 2020 r. Użyj w zamian zasady AutocompleteOptions.fields: fields: ['place_id', 'name', 'types']. 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.

Klasa SearchBox

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.

Zespół
SearchBox	SearchBox(inputField[, opts]) Parametry:  inputField:  HTMLInputElement opts:  SearchBoxOptions optional Tworzy nowe wystąpienie obiektu SearchBox, które dołącza do określonego pola tekstowego wejściowego z podanymi opcjami.

Metody
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:  bounds:  LatLngBounds|LatLngBoundsLiteral optional 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

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

Właściwości
bounds optional	Typ:  LatLngBounds|LatLngBoundsLiteral optional Obszar, na który mają być ukierunkowane prognozy zapytań. Prognozy ukierunkowują zapytania kierowane na te wartości progowe, lecz nie tylko.