Places Widgets

PlaceAutocompleteElement class

google.maps.places.PlaceAutocompleteElement zajęcia

PlaceAutocompleteElement to podklasa HTMLElement, która udostępnia komponent interfejsu do interfejsu Places Autocomplete API.

Element niestandardowy:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng|lat,lng,altitude" requested-language="string" requested-region="string" unit-system="metric|imperial" types="type1 type2 type3..."></gmp-place-autocomplete>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceAutocompleteElementOptions.

Dostęp przez połączenie pod numer const {PlaceAutocompleteElement} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parametry: 
AlphaincludedPrimaryTypes
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.
Atrybut HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
AlphaincludedRegionCodes
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.
Atrybut HTML:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
Typ:  LocationBias optional
Miękka granica lub wskazówka używana podczas wyszukiwania miejsc.
locationRestriction
Typ:  LocationRestriction optional
Granice ograniczające wyniki wyszukiwania.
name
Typ:  string optional
Nazwa 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. Pamiętaj, że ta nazwa będzie używana po przesłaniu formularza. Szczegółowe informacje znajdziesz na stronie https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Atrybut HTML:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
Alphaorigin
Punkt początkowy, od którego ma zostać obliczona odległość. Jeśli nie określisz tu żadnej wartości, odległość nie będzie obliczana. Wysokość, jeśli jest podana, nie jest uwzględniana w obliczeniach.
Atrybut HTML:
  • <gmp-place-autocomplete origin="lat,lng|lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage
Typ:  string optional
Identyfikator języka, w którym mają być zwracane wyniki (jeśli to możliwe). Wyniki w wybranym języku mogą mieć wyższą pozycję, 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 używany do formatowania i filtrowania wyników. Nie ogranicza to sugestii do tego kraju. Kod regionu akceptuje 2-znakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”).
Atrybut HTML:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
AlphaunitSystem
Typ:  UnitSystem optional
Układ jednostek używany do wyświetlania odległości. Jeśli nie zostanie określony, system jednostek zostanie określony przez parametr requestedRegion.
Atrybut HTML:
  • <gmp-place-autocomplete unit-system="metric|imperial"></gmp-place-autocomplete>
BetacomponentRestrictions
Typ:  ComponentRestrictions optional
Ograniczenia dotyczące komponentu. Ograniczenia komponentu służą do ograniczania prognoz tylko do tych, które znajdują się w komponencie nadrzędnym. Na przykład kraj.
Betatypes
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 określisz typów, zostaną zwrócone wszystkie typy.
Atrybut HTML:
  • <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>
prediction-item
Element w menu prognoz, który reprezentuje pojedynczą prognozę.
prediction-item-icon
Ikona wyświetlana po lewej stronie każdego elementu na liście prognoz.
prediction-item-main-text
Część elementu prognozy, która jest głównym tekstem prognozy. W przypadku lokalizacji geograficznych zawiera nazwę miejsca, np. „Sydney”, lub nazwę ulicy i numer, np. „10 King Street”. Domyślnie tekst prediction-item-main-text jest czarny. Jeśli w elemencie prognozy znajduje się dodatkowy tekst, jest on umieszczony poza elementem prediction-item-main-text i dziedziczy styl z elementu prediction-item. Domyślnie jest on szary. Dodatkowy tekst to zwykle adres.
prediction-item-match
Część zwróconej prognozy, która pasuje do danych wpisanych przez użytkownika. Domyślnie pasujący tekst jest wyróżniony pogrubieniem. Pamiętaj, że dopasowany tekst może znajdować się w dowolnym miejscu w elemencie prognozy. Nie musi być częścią elementu prediction-item-main-text.
prediction-item-selected
Element, gdy użytkownik przechodzi do niego za pomocą klawiatury. Uwaga: na wybrane elementy będą miały wpływ zarówno style części, jak i style części elementu prognozy.
prediction-list
Element wizualny zawierający listę prognoz zwróconych przez usługę autouzupełniania miejsc. Ta lista pojawia się jako lista rozwijana pod elementem PlaceAutocompleteElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string Ciąg znaków z uwzględnieniem wielkości liter reprezentujący typ zdarzenia, którego chcesz nasłuchiwać.
  • 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 capture i passive.
Zwracana wartość:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków określający typ zdarzenia, dla którego ma zostać usunięty detektor zdarzeń.
  • listener:  EventListener|EventListenerObject Detektor zdarzeń modułu obsługi zdarzeń, który ma zostać usunięty z obiektu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional zobacz opcje.
Zwracana wartość:  void
Usuwa z obiektu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
gmp-error
function(errorEvent)
Argumenty: 
To zdarzenie jest uruchamiane, gdy żądanie do backendu zostało odrzucone (np. z powodu nieprawidłowego klucza interfejsu API). To zdarzenie nie jest propagowane.
gmp-select
function(placePredictionSelectEvent)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik wybierze prognozę miejsca. Zawiera obiekt PlacePrediction, który można przekonwertować na obiekt Place.
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik wybierze prognozę miejsca. Zawiera obiekt Place.

PlaceAutocompleteElementOptions interfejs

google.maps.places.PlaceAutocompleteElementOptionsinterfejs

Opcje tworzenia elementu PlaceAutocompleteElement. Opis każdej właściwości znajdziesz w klasie PlaceAutocompleteElement.
BetacomponentRestrictions optional
Typ:  ComponentRestrictions optional
AlphaincludedPrimaryTypes optional
Typ:  Array<string> optional
AlphaincludedRegionCodes optional
Typ:  Array<string> optional
locationBias optional
Typ:  LocationBias optional
locationRestriction optional
Typ:  LocationRestriction optional
name optional
Typ:  string optional
Alphaorigin optional
requestedLanguage optional
Typ:  string optional
Betatypes optional
Typ:  Array<string> optional
AlphaunitSystem optional
Typ:  UnitSystem optional

PlaceAutocompletePlaceSelectEvent class

google.maps.places.PlaceAutocompletePlaceSelectEvent zajęcia

To zdarzenie jest tworzone po wybraniu przez użytkownika miejsca za pomocą elementu autouzupełniania miejsc. Otwórz zaznaczenie, klikając event.place.

Ta klasa rozszerza klasę Event.

Dostęp przez połączenie pod numer const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
Betaplace
Typ:  Place

PlacePredictionSelectEvent class

google.maps.places.PlacePredictionSelectEvent zajęcia

To zdarzenie jest tworzone po wybraniu przez użytkownika elementu prognozy za pomocą elementu PlaceAutocompleteElement. Otwórz zaznaczenie, klikając event.placePrediction.

Ta klasa rozszerza klasę Event.

Dostęp przez połączenie pod numer const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
placePrediction

PlaceAutocompleteRequestErrorEvent class

google.maps.places.PlaceAutocompleteRequestErrorEvent zajęcia

To zdarzenie jest emitowane przez element PlaceAutocompleteElement, gdy wystąpi problem z żądaniem sieciowym.

Ta klasa rozszerza klasę Event.

Dostęp przez połączenie pod numer const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.

PlaceDetailsElement class

google.maps.places.PlaceDetailsElement zajęcia

Element HTML, który wyświetla szczegóły miejsca. Aby określić treść do wyrenderowania, użyj metod configureFromPlace() lub configureFromLocation(). Aby używać elementu szczegółów miejsca, włącz interfejs Places UI Kit API w projekcie w konsoli Google Cloud.

Element niestandardowy:
<gmp-place-details size="small"></gmp-place-details>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceDetailsElementOptions.

Dostęp przez połączenie pod numer const {PlaceDetailsElement} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
PlaceDetailsElement
PlaceDetailsElement([options])
Parametry: 
place
Typ:  Place optional
Tylko do odczytu. Place obiekt zawierający identyfikator, lokalizację i obszar widoczny obecnie renderowanego miejsca.
size
Typ:  PlaceDetailsSize optional
Wariant rozmiaru elementu PlaceDetailsElement. Domyślnie element będzie wyświetlać symbol PlaceDetailsSize.X_LARGE.
Atrybut HTML:
  • <gmp-place-details size="small"></gmp-place-details>
  • <gmp-place-details size="medium"></gmp-place-details>
  • <gmp-place-details size="large"></gmp-place-details>
  • <gmp-place-details size="x-large"></gmp-place-details>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string Ciąg znaków z uwzględnieniem wielkości liter reprezentujący typ zdarzenia, którego chcesz nasłuchiwać.
  • 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 capture i passive.
Zwracana wartość:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
configureFromLocation
configureFromLocation(location)
Parametry: 
  • location:  LatLng|LatLngLiteral lokalizacja, dla której mają być renderowane szczegóły miejsca.
Wartość zwracana:  Promise<void> obietnica, która zostanie spełniona po wczytaniu i wyrenderowaniu danych o miejscu.
Konfiguruje widżet na podstawie LatLng za pomocą geokodowania zwrotnego.
configureFromPlace
configureFromPlace(place)
Parametry: 
  • place:  Place|{id:string} Miejsce, w którym mają być wyświetlane szczegóły.
Wartość zwracana:  Promise<void> obietnica, która zostanie spełniona po wczytaniu i wyrenderowaniu danych o miejscu.
Konfiguruje widżet na podstawie obiektu Place lub identyfikatora miejsca.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków określający typ zdarzenia, dla którego ma zostać usunięty detektor zdarzeń.
  • listener:  EventListener|EventListenerObject Detektor zdarzeń modułu obsługi zdarzeń, który ma zostać usunięty z obiektu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional zobacz opcje.
Zwracana wartość:  void
Usuwa z obiektu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
gmp-load
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy element wczytuje i renderuje swoją zawartość. To zdarzenie nie jest propagowane.
gmp-requesterror
function(event)
Argumenty: 
To zdarzenie jest uruchamiane, gdy żądanie do backendu zostało odrzucone (np. z powodu nieprawidłowego klucza interfejsu API). To zdarzenie nie jest propagowane.

PlaceDetailsElementOptions interfejs

google.maps.places.PlaceDetailsElementOptionsinterfejs

Opcje dotyczące PlaceDetailsElement.
size optional
Typ:  PlaceDetailsSize optional
Zobacz: PlaceDetailsElement.size

PlaceDetailsSize stałe

google.maps.places.PlaceDetailsSize stałe

Wersje rozmiarowe dla konta PlaceDetailsElement.

Dostęp przez połączenie pod numer const {PlaceDetailsSize} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
LARGE Duży wariant zawierający duży obraz, podstawowe informacje i dane kontaktowe.
MEDIUM Wersja średnia zawierająca duży obraz i podstawowe informacje.
SMALL Mały wariant zawierający mały obraz i podstawowe informacje.
X_LARGE Wersja bardzo duża, która zawiera kolaż zdjęć, opinie i szczegółowe informacje o miejscu.

PlaceListElement class

google.maps.places.PlaceListElement zajęcia

Element HTML, który wyświetla wyniki wyszukiwania miejsca w formie listy. Aby określić żądanie, dla którego mają być renderowane wyniki, użyj metod configureFromSearchByTextRequest() lub configureFromSearchNearbyRequest(). Aby używać elementu listy miejsc, włącz interfejs Places UI Kit API w projekcie w konsoli Google Cloud.

Element niestandardowy:
<gmp-place-list selectable></gmp-place-list>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceListElementOptions.

Dostęp przez połączenie pod numer const {PlaceListElement} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
PlaceListElement
PlaceListElement([options])
Parametry: 
places
Typ:  Array<Place>
Tylko do odczytu. Tablica obiektów Place zawierająca identyfikatory, lokalizacje i obszary widoku aktualnie renderowanych miejsc.
selectable
Typ:  boolean
Czy elementy listy można wybrać. Jeśli ma wartość true, elementy listy będą przyciskami, które po kliknięciu wysyłają zdarzenie gmp-placeselect. Obsługiwana jest też dostępna nawigacja i wybór za pomocą klawiatury.
Atrybut HTML:
  • <gmp-place-list selectable></gmp-place-list>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string Ciąg znaków z uwzględnieniem wielkości liter reprezentujący typ zdarzenia, którego chcesz nasłuchiwać.
  • 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 capture i passive.
Zwracana wartość:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
configureFromSearchByTextRequest
configureFromSearchByTextRequest(request)
Parametry: 
  • request:  SearchByTextRequest żądanie renderowania wyników. Właściwość fields elementu SearchByTextRequest nie jest wymagana.
Wartość zwracana:  Promise<void> obietnica, która zostanie spełniona po wczytaniu i wyrenderowaniu danych o miejscu.
Konfiguruje widżet tak, aby renderował wyniki wyszukiwania z żądania do interfejsu Places Text Search API.
configureFromSearchNearbyRequest
configureFromSearchNearbyRequest(request)
Parametry: 
  • request:  SearchNearbyRequest żądanie renderowania wyników. Właściwość fields elementu SearchNearbyRequest nie jest wymagana.
Wartość zwracana:  Promise<void> obietnica, która zostanie spełniona po wczytaniu i wyrenderowaniu danych o miejscu.
Konfiguruje widżet tak, aby renderował wyniki wyszukiwania z żądania interfejsu Places Nearby Search API.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków określający typ zdarzenia, dla którego ma zostać usunięty detektor zdarzeń.
  • listener:  EventListener|EventListenerObject Detektor zdarzeń modułu obsługi zdarzeń, który ma zostać usunięty z obiektu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional zobacz opcje.
Zwracana wartość:  void
Usuwa z obiektu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
gmp-load
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy element wczytuje i renderuje swoją zawartość. To zdarzenie nie jest propagowane.
gmp-placeselect
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik wybierze miejsce. Zawiera obiekt Place i indeks wybranego miejsca na liście.
gmp-requesterror
function(event)
Argumenty: 
To zdarzenie jest uruchamiane, gdy żądanie do backendu zostało odrzucone (np. z powodu nieprawidłowego klucza interfejsu API). To zdarzenie nie jest propagowane.

PlaceListElementOptions interfejs

google.maps.places.PlaceListElementOptionsinterfejs

Opcje dotyczące PlaceListElement.
selectable optional
Typ:  boolean optional
Zobacz: PlaceListElement.selectable

PlaceListPlaceSelectEvent class

google.maps.places.PlaceListPlaceSelectEvent zajęcia

To zdarzenie jest emitowane przez PlaceListElement, gdy użytkownik wybierze miejsce.

Ta klasa rozszerza klasę Event.

Dostęp przez połączenie pod numer const {PlaceListPlaceSelectEvent} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
index
Typ:  number
Indeks listy wybranego miejsca.
place
Typ:  Place
Obiekt Place zawierający identyfikator, lokalizację i obszar widoku wybranego miejsca.

Klasa Autocomplete

google.maps.places.Autocomplete zajęcia

Widżet, który na podstawie tekstu wpisanego przez użytkownika podaje prognozy dotyczące miejsc. Jest dołączony do elementu wejściowego typu text i nasłuchuje wpisywania tekstu w tym polu. Lista prognoz jest wyświetlana jako lista rozwijana i aktualizowana w miarę wpisywania tekstu.

Ta klasa rozszerza klasę MVCObject.

Dostęp przez połączenie pod numer const {Autocomplete} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
Autocomplete
Autocomplete(inputField[, opts])
Parametry: 
Tworzy nową instancję Autocomplete, która jest dołączana do określonego pola tekstowego z podanymi opcjami.
getBounds
getBounds()
Parametry: brak
Zwracana wartość:  LatLngBounds|undefined granice odchylenia.
Zwraca zakres, w którym prognozy są obciążone.
getFields
getFields()
Parametry: brak
Zwracana wartość:  Array<string>|undefined
Zwraca pola, które mają być uwzględnione w odpowiedzi ze szczegółami miejsca, gdy szczegóły zostaną pobrane. Listę pól znajdziesz na stronie PlaceResult.
getPlace
getPlace()
Parametry: brak
Wartość zwracana:  PlaceResult miejsce wybrane przez użytkownika.
Zwraca szczegóły miejsca wybranego przez użytkownika, jeśli zostały one pobrane. W przeciwnym razie zwraca obiekt Place z właściwością name ustawioną na bieżącą wartość pola wejściowego.
setBounds
setBounds(bounds)
Parametry: 
Zwracana wartość: brak
Określa preferowany obszar, w którym mają być zwracane wyniki dotyczące miejsc. Wyniki są ukierunkowane na ten obszar, ale nie są do niego ograniczone.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parametry: 
Zwracana wartość: brak
Ustawia ograniczenia komponentu. Ograniczenia komponentu służą do ograniczania prognoz tylko do tych, które znajdują się w komponencie nadrzędnym. Na przykład kraj.
setFields
setFields(fields)
Parametry: 
  • fields:  Array<string> optional
Zwracana wartość: brak
Określa pola, które mają być uwzględnione w odpowiedzi ze szczegółami miejsca po ich pobraniu. 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ą być 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 określisz typów, zostaną zwrócone wszystkie typy.
Odziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy PlaceResult jest udostępniana w miejscu wybranym przez użytkownika.
Jeśli użytkownik wpisze nazwę miejsca, która nie została zasugerowana przez kontrolkę, i naciśnie klawisz Enter lub jeśli żądanie szczegółów miejsca nie powiedzie się, obiekt PlaceResult będzie zawierać dane wejściowe użytkownika we właściwości name bez zdefiniowanych innych właściwości.

AutocompleteOptions interfejs

google.maps.places.AutocompleteOptionsinterfejs

Opcje, które można ustawić w obiekcie Autocomplete.
bounds optional
Obszar, w którym chcesz wyszukać miejsca.
componentRestrictions optional
Typ:  ComponentRestrictions optional
Ograniczenia dotyczące komponentu. Ograniczenia komponentu służą do ograniczania prognoz tylko do tych, które znajdują się w komponencie nadrzędnym. Na przykład kraj.
fields optional
Typ:  Array<string> optional
Pola, które mają być uwzględnione w odpowiedzi ze szczegółami miejsca po ich pobraniu (za które zostanie naliczona opłata). Jeśli przekażesz wartość ['ALL'], zwracane będą wszystkie dostępne pola, za które będziesz płacić (nie jest to zalecane w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz na stronie PlaceResult. Pola zagnieżdżone można określić za pomocą ścieżek z kropkami (np. "geometry.location"). Wartość domyślna to ['ALL'].
placeIdOnly optional
Typ:  boolean optional
Określa, czy mają być pobierane tylko identyfikatory miejsc. Obiekt PlaceResult udostępniany po wywołaniu zdarzenia place_changed będzie zawierać tylko pola place_id, types i name, a pola place_id, types i description będą zwracane przez usługę Autocomplete. Domyślnie wyłączona.
strictBounds optional
Typ:  boolean optional
Wartość logiczna wskazująca, że widżet autouzupełniania ma zwracać tylko te miejsca, które w momencie wysłania zapytania znajdują się w jego granicach. Ustawienie parametru strictBounds na false (wartość domyślna) spowoduje, że wyniki będą bardziej ukierunkowane na miejsca znajdujące się w granicach, ale nie będą się do nich ograniczać.
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 określisz typów, zostaną zwrócone wszystkie typy.

google.maps.places.SearchBox zajęcia

Widżet, który wyświetla prognozy zapytań na podstawie tekstu wpisanego przez użytkownika. Jest dołączony do elementu wejściowego typu text i nasłuchuje wpisywania tekstu w tym polu. Lista prognoz jest wyświetlana jako lista rozwijana i aktualizowana w miarę wpisywania tekstu.

Ta klasa rozszerza klasę MVCObject.

Dostęp przez połączenie pod numer const {SearchBox} = await google.maps.importLibrary("places").
 Zobacz Biblioteki w Maps JavaScript API.
SearchBox
SearchBox(inputField[, opts])
Parametry: 
Tworzy nową instancję SearchBox, która jest dołączana do określonego pola tekstowego z podanymi opcjami.
getBounds
getBounds()
Parametry: brak
Zwracana wartość:  LatLngBounds|undefined
Zwraca granice, do których są odchylone prognozy z zapytania.
getPlaces
getPlaces()
Parametry: brak
Zwracana wartość:  Array<PlaceResult>|undefined
Zwraca zapytanie wybrane przez użytkownika do użycia ze zdarzeniem places_changed.
setBounds
setBounds(bounds)
Parametry: 
Zwracana wartość: brak
Ustawia region, który ma być używany do określania prognoz zapytań. Wyniki będą tylko ukierunkowane na ten obszar, ale nie będą do niego całkowicie ograniczone.
Odziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy użytkownik wybierze zapytanie. getPlaces powinno być używane do uzyskiwania nowych miejsc.

SearchBoxOptions interfejs

google.maps.places.SearchBoxOptionsinterfejs

Opcje, które można ustawić w obiekcie SearchBox.
bounds optional
Obszar, w którym mają być faworyzowane prognozy zapytań. Prognozy są ukierunkowane na zapytania dotyczące tych zakresów, ale nie są do nich ograniczone.