Places Widgets

Klasa PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement zajęcia

PlaceAutocompleteElement to podklasa HTMLElement, która udostępnia komponent interfejsu dla interfejsu API Autouzupełniania miejsc.

Element PlaceAutocompleteElement automatycznie używa wewnętrznie AutocompleteSessionToken, aby grupować fazy zapytania i wyboru w ramach wyszukiwania z autouzupełnianiem przez użytkownika.

Pierwsze wywołanie metody Place.fetchFields w obiekcie Place zwróconym przez PlacePrediction.toPlace będzie automatycznie zawierać token sesji użyty do pobrania obiektu PlacePrediction.

Więcej informacji o tym, jak działają sesje, znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/place-session-tokens.

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

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceAutocompleteElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceAutocompleteElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parametry: 
includedPrimaryTypes
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.
Atrybut HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
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.
Atrybut HTML:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
Typ:  LocationBias optional
Miękka granica lub wskazówka do użycia podczas wyszukiwania miejsc.
locationRestriction
Typ:  LocationRestriction optional
Granice ograniczające wyniki wyszukiwania.
name
Typ:  string optional
Nazwa, która ma być używana w przypadku elementu wejściowego. Więcej informacji 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. Więcej informacji znajdziesz na stronie https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Atrybut HTML:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
Punkt początkowy, od którego ma być obliczana odległość. Jeśli nie określisz tej wartości, odległość nie zostanie obliczona. Wysokość, jeśli jest podana, nie jest używana w obliczeniach.
Atrybut HTML:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
placeholder
Typ:  string
Tekst zastępczy, który ma się wyświetlać w elemencie wejściowym.
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ę, 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 jest używany do formatowania i filtrowania wyników. Nie ogranicza 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 domena ccTLD Wielkiej Brytanii to „uk” (.co.uk), a jej 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>
unitSystem
Typ:  UnitSystem optional
Układ jednostek używany do wyświetlania odległości. Jeśli nie zostanie określony, system jednostek jest określany przez parametr requestedRegion.
Atrybut HTML:
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
value
Typ:  string
Wartość elementu wejściowego.
prediction-item-icon
To miejsce akceptuje dokładnie 1 element <template>, który jest renderowany jako ikona wyświetlana obok elementu podpowiedzi.
input
Element wejściowy elementu autouzupełniania.
prediction-item
Element w menu podpowiedzi, który reprezentuje pojedynczą podpowiedź.
prediction-item-icon
Ikona wyświetlana po lewej stronie każdego elementu na liście podpowiedzi.
prediction-item-main-text
Część elementu podpowiedzi, która jest głównym tekstem podpowiedzi. W przypadku położeń geograficznych zawiera nazwę miejsca, np. „Sydney”, lub nazwę ulicy i numer, np. „ul. Królewska 10”. Domyślnie element prediction-item-main-text jest czarny. Jeśli w elemencie prediction-item znajduje się dodatkowy tekst, jest on poza elementem prediction-item-main-text i dziedziczy styl z elementu prediction-item. Domyślnie jest szary. Dodatkowy tekst to zwykle adres.
prediction-item-match
Część zwróconej podpowiedzi, która pasuje do danych wpisanych przez użytkownika. Domyślnie dopasowany tekst jest pogrubiony. Pamiętaj, że dopasowany tekst może znajdować się w dowolnym miejscu w elemencie prediction-item. 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 tej części, jak i style części podpowiedzi.
prediction-list
Element wizualny zawierający listę podpowiedzi zwróconych przez usługę autouzupełniania miejsc. Ta lista pojawia się jako lista rozwijana pod elementem PlaceAutocompleteElement.
background-color
Zastępuje kolor tła elementu.
border
Zastępuje obramowanie elementu.
border-radius
Zastępuje promień obramowania elementu.
color
Zastępuje czcionkę elementu.
color-scheme
Wskazuje, w jakim schemacie kolorów może być renderowany ten element. Więcej informacji znajdziesz w color-scheme dokumentacji. Domyślna wartość to color-scheme: light dark.
font
Zastępuje czcionkę elementu.
font-family
Zastępuje czcionkę elementu.
font-size
Zastępuje czcionkę elementu.
font-style
Zastępuje czcionkę elementu.
font-weight
Zastępuje czcionkę elementu.
line-height
Zastępuje czcionkę elementu.
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
gmp-error
function(errorEvent)
Argumenty: 
To zdarzenie jest wywoływane, gdy żądanie do backendu zostało odrzucone (np. nieprawidłowy klucz interfejsu API). To zdarzenie nie jest przekazywane w górę.
gmp-select
function(placePredictionSelectEvent)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik wybierze podpowiedź miejsca. Zawiera obiekt PlacePrediction, który można przekonwertować na obiekt Place.

PlaceAutocompleteElementOptions

Interfejs google.maps.places.PlaceAutocompleteElementOptions

Opcje tworzenia elementu PlaceAutocompleteElement. Opis każdej właściwości znajdziesz we właściwości o tej samej nazwie w klasie PlaceAutocompleteElement.
includedPrimaryTypes optional
Typ:  Array<string> optional
includedRegionCodes optional
Typ:  Array<string> optional
locationBias optional
Typ:  LocationBias optional
locationRestriction optional
Typ:  LocationRestriction optional
name optional
Typ:  string optional
origin optional
requestedLanguage optional
Typ:  string optional
requestedRegion optional
Typ:  string optional
unitSystem optional
Typ:  UnitSystem optional
value optional
Typ:  string optional
Wartość elementu wejściowego.

Klasa PlacePredictionSelectEvent

google.maps.places.PlacePredictionSelectEvent zajęcia

To zdarzenie jest tworzone, gdy użytkownik wybierze element podpowiedzi za pomocą PlaceAutocompleteElement. Aby uzyskać dostęp do wyboru, naciśnij event.placePrediction.

Przekonwertuj placePrediction na Place, wywołując PlacePrediction.toPlace.

Ta klasa rozszerza klasę Event.

Aby uzyskać dostęp, zadzwoń pod numer const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
placePrediction
Przekształć to w Place, wywołując PlacePrediction.toPlace.

BasicPlaceAutocompleteElement class

google.maps.places.BasicPlaceAutocompleteElement zajęcia

BasicPlaceAutocompleteElement to podklasa HTMLElement, która udostępnia komponent interfejsu dla interfejsu Autouzupełniania miejsc API.

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

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs BasicPlaceAutocompleteElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
BasicPlaceAutocompleteElement
BasicPlaceAutocompleteElement(options)
Parametry: 
includedPrimaryTypes
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.
Atrybut HTML:
  • <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes
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.
Atrybut HTML:
  • <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-place-autocomplete>
locationBias
Typ:  LocationBias optional
Miękka granica lub wskazówka do użycia podczas wyszukiwania miejsc.
locationRestriction
Typ:  LocationRestriction optional
Granice ograniczające wyniki wyszukiwania.
name
Typ:  string optional
Nazwa, która ma być używana w przypadku elementu wejściowego. Więcej informacji 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. Więcej informacji znajdziesz na stronie https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Atrybut HTML:
  • <gmp-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin
Punkt początkowy, od którego ma być obliczana odległość. Jeśli nie określisz tej wartości, odległość nie zostanie obliczona. Wysokość, jeśli jest podana, nie jest używana w obliczeniach.
Atrybut HTML:
  • <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
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ę, ale sugestie nie są ograniczone do tego języka. Zobacz listę obsługiwanych języków.
Atrybut HTML:
  • <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion
Typ:  string optional
Kod regionu, który jest używany do formatowania i filtrowania wyników. Nie ogranicza 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 domena ccTLD Wielkiej Brytanii to „uk” (.co.uk), a jej kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”).
Atrybut HTML:
  • <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem
Typ:  UnitSystem optional
Układ jednostek używany do wyświetlania odległości. Jeśli nie zostanie określony, system jednostek jest określany przez parametr requestedRegion.
Atrybut HTML:
  • <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>
prediction-item-icon
To miejsce akceptuje dokładnie 1 element <template>, który jest renderowany jako ikona wyświetlana obok elementu podpowiedzi.
input
Element wejściowy elementu autouzupełniania.
prediction-item
Element w menu podpowiedzi, który reprezentuje pojedynczą podpowiedź.
prediction-item-icon
Ikona wyświetlana po lewej stronie każdego elementu na liście podpowiedzi.
prediction-item-main-text
Część elementu podpowiedzi, która jest głównym tekstem podpowiedzi. W przypadku położeń geograficznych zawiera nazwę miejsca, np. „Sydney”, lub nazwę ulicy i numer, np. „ul. Królewska 10”. Domyślnie element prediction-item-main-text jest czarny. Jeśli w elemencie prediction-item znajduje się dodatkowy tekst, jest on poza elementem prediction-item-main-text i dziedziczy styl z elementu prediction-item. Domyślnie jest szary. Dodatkowy tekst to zwykle adres.
prediction-item-match
Część zwróconej podpowiedzi, która pasuje do danych wpisanych przez użytkownika. Domyślnie dopasowany tekst jest pogrubiony. Pamiętaj, że dopasowany tekst może znajdować się w dowolnym miejscu w elemencie prediction-item. 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 tej części, jak i style części podpowiedzi.
prediction-list
Element wizualny zawierający listę podpowiedzi zwróconych przez usługę autouzupełniania miejsc. Ta lista pojawia się jako lista rozwijana pod elementem PlaceAutocompleteElement.
background-color
Zastępuje kolor tła elementu.
border
Zastępuje obramowanie elementu.
border-radius
Zastępuje promień obramowania elementu.
color
Zastępuje czcionkę elementu.
color-scheme
Wskazuje, w jakim schemacie kolorów może być renderowany ten element. Więcej informacji znajdziesz w color-scheme dokumentacji. Domyślna wartość to color-scheme: light dark.
font
Zastępuje czcionkę elementu.
font-family
Zastępuje czcionkę elementu.
font-size
Zastępuje czcionkę elementu.
font-style
Zastępuje czcionkę elementu.
font-weight
Zastępuje czcionkę elementu.
line-height
Zastępuje czcionkę elementu.
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
gmp-error
function(errorEvent)
Argumenty: 
To zdarzenie jest wywoływane, gdy żądanie do backendu zostało odrzucone (np. nieprawidłowy klucz interfejsu API). To zdarzenie nie jest przekazywane w górę.
gmp-select
function(placeSelectEvent)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik wybierze podpowiedź miejsca. Zawiera obiekt Place.

Interfejs BasicPlaceAutocompleteElementOptions

Interfejs google.maps.places.BasicPlaceAutocompleteElementOptions

Opcje tworzenia elementu BasicPlaceAutocompleteElement.
includedPrimaryTypes optional
Typ:  Array<string> optional
includedRegionCodes optional
Typ:  Array<string> optional
locationBias optional
Typ:  LocationBias optional
locationRestriction optional
Typ:  LocationRestriction optional
name optional
Typ:  string optional
origin optional
requestedLanguage optional
Typ:  string optional
requestedRegion optional
Typ:  string optional
unitSystem optional
Typ:  UnitSystem optional

Klasa PlaceDetailsElement

google.maps.places.PlaceDetailsElement zajęcia

Wyświetla szczegóły miejsca w pełnym układzie. Dołącz PlaceDetailsPlaceRequestElement lub PlaceDetailsLocationRequestElement, aby określić miejsce, które ma zostać wyrenderowane. Dołącz PlaceContentConfigElement, PlaceStandardContentElement lub PlaceAllContentElement, aby określić, które treści mają być renderowane.

Przykład: 

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details>

Aby używać tego elementu, włącz w projekcie w konsoli Google Cloud interfejs Places UI Kit API.

Element niestandardowy:
<gmp-place-details></gmp-place-details>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceDetailsElementOptions.

Aby uzyskać dostęp, zadzwoń 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. Obiekt miejsca zawierający identyfikator, lokalizację i widoczny obszar aktualnie renderowanego miejsca.
--gmp-button-border-color
Kolor obramowania przycisku „Otwórz w Mapach”.
--gmp-button-border-radius
Promień obramowania przycisku „Otwórz w Mapach”.
--gmp-button-border-width
Szerokość obramowania przycisku „Otwórz w Mapach”.
--gmp-collage-border-radius-outer
Promień obramowania zewnętrznych rogów kolażu multimedialnego.
--gmp-dialog-border-radius
Promień obramowania okna ujawniania informacji w Mapach Google.
--gmp-mat-color-disabled-surface
Kolor powierzchni, który ma wskazywać stan wyłączenia lub brak obecności. Używany w przypadku pustych gwiazdek opinii.
--gmp-mat-color-info
Kolor elementów interfejsu o charakterze informacyjnym. Używany w przypadku ikony wózka inwalidzkiego.
--gmp-mat-color-negative
Kolor elementów interfejsu o negatywnym wydźwięku. Używany w tekście „Zamknięte” w stanie „Otwarte teraz”.
--gmp-mat-color-neutral-container
Kolor kontenera dla neutralnych wypełnionych elementów interfejsu. Używany w przypadku obiektów zastępczych obrazów i plakietki z datą publikacji opinii.
--gmp-mat-color-on-neutral-container
Kolor tekstu i ikon na tle neutralnego koloru kontenera. Używany w przypadku plakietki z datą opublikowania opinii i plakietki z informacją o dostępności ładowarki EV, gdy jest ona niedostępna.
--gmp-mat-color-on-positive-container
Kolor tekstów i ikon na tle koloru kontenera pozytywnego. Używane w przypadku plakietki dostępności ładowarki EV, jeśli jest dostępna.
--gmp-mat-color-on-secondary-container
Kolor tekstu i ikon na tle dodatkowego koloru kontenera. Używany do tekstu i ikon na przycisku „Otwórz w Mapach”.
--gmp-mat-color-on-surface
Kolor tekstu i ikon na dowolnym kolorze powierzchni. Używany do zwykłego tekstu.
--gmp-mat-color-on-surface-variant
Kolor o mniejszym nacisku dla tekstu i ikon na dowolnym kolorze powierzchni. Używany w przypadku mniej wyróżnionego tekstu.
--gmp-mat-color-outline-decorative
Kolor konturu elementów nieinteraktywnych. Używany do obramowania elementu.
--gmp-mat-color-positive
Kolor elementów interfejsu o pozytywnym wydźwięku. Używany w tekście „Otwarte” w stanie „Otwarte teraz”.
--gmp-mat-color-positive-container
Kolor kontenera elementów interfejsu, które wywołują pozytywne emocje. Używane w przypadku plakietki dostępności ładowarki EV, jeśli jest dostępna.
--gmp-mat-color-primary
Kolor interaktywnego tekstu i ikon na tle koloru powierzchni. Używany w liczbie opinii, linkach w oknie ujawniania informacji w Mapach Google, linku do witryny, ikonach na karcie Przegląd oraz (po najechaniu kursorem / zaznaczeniu / kolorze tekstu) w tytułach na pasku kart.
--gmp-mat-color-secondary-container
Mniej widoczny kolor wypełnienia na powierzchni, przeznaczony do komponentów drugorzędnych, takich jak przyciski tonalne. Używany jako tło przycisku „Otwórz w Mapach”.
--gmp-mat-color-surface
Kolor tła. Używany jako tło elementu i okna z informacjami o Mapach Google.
--gmp-mat-font-body-medium
Używany w oknie dialogowym ujawniania informacji w Mapach Google do wyświetlania adresu, oceny, typu, ceny, stanu otwarcia, godzin otwarcia, opinii, numeru telefonu, witryny, plus code, najważniejszych funkcji i tekstu.
--gmp-mat-font-body-small
Używany w treści listy funkcji na karcie „Informacje”.
--gmp-mat-font-display-small
Używane jako nazwa miejsca i tekst nagłówka każdej funkcji na karcie „Informacje”.
--gmp-mat-font-family
Podstawowa rodzina czcionek używana we wszystkich tekstach.
--gmp-mat-font-headline-medium
Używany jako tekst nagłówka w oknie ujawniania informacji w Mapach Google.
--gmp-mat-font-label-large
Używany w tytułach kart, przycisku „Otwórz w Mapach”, tekście informacji o pochodzeniu danych w galerii zdjęć, tekście informacji o pochodzeniu danych w sekcji opinii oraz linkach w oknie ujawniania informacji w Mapach Google.
--gmp-mat-font-label-medium
Używane w przypadku plakietki z liczbą zdjęć i plakietki z datą opublikowania opinii.
--gmp-mat-font-title-small
Używany jako tytuł każdej sekcji na karcie „Informacje”.
--gmp-mat-spacing-extra-large
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-extra-small
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-large
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-medium
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-small
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-two-extra-large
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-star-rating-color
Kolor wypełnionych gwiazdek w ocenie.
background-color
Zastępuje kolor tła elementu.
border
Zastępuje obramowanie elementu.
border-radius
Zastępuje promień obramowania elementu.
color-scheme
Wskazuje, w jakim schemacie kolorów może być renderowany ten element. Więcej informacji znajdziesz w color-scheme dokumentacji. Domyślna wartość to color-scheme: light dark.
font-size
Skaluje cały tekst i ikony w elemencie, które są zdefiniowane wewnętrznie w em. Domyślna wartość to 16px.
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
gmp-error
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy żądanie do backendu zostało odrzucone (np. nieprawidłowy klucz interfejsu API). To zdarzenie nie jest przekazywane w górę.
gmp-load
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy element wczytuje i renderuje swoją zawartość. To zdarzenie nie jest przekazywane w górę.

PlaceDetailsElementOptions interface

Interfejs google.maps.places.PlaceDetailsElementOptions

Opcje dotyczące: PlaceDetailsElement.

Klasa PlaceDetailsCompactElement

google.maps.places.PlaceDetailsCompactElement zajęcia

Wyświetla szczegóły miejsca w kompaktowym układzie. Dodaj PlaceDetailsPlaceRequestElement lub PlaceDetailsLocationRequestElement, aby określić miejsce do wyrenderowania. Dołącz PlaceContentConfigElement, PlaceStandardContentElement lub PlaceAllContentElement, aby określić, które treści mają być renderowane.

Przykład: 

 <gmp-place-details-compact>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details-compact>

Aby używać tego elementu, włącz w projekcie w konsoli Google Cloud interfejs Places UI Kit API.

Element niestandardowy:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceDetailsCompactElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
Parametry: 
orientation
Typ:  PlaceDetailsOrientation optional
Domyślnie: PlaceDetailsOrientation.VERTICAL
Wariant orientacji (pionowej lub poziomej) elementu.
Atrybut HTML:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
Typ:  Place optional
Tylko do odczytu. Obiekt miejsca zawierający identyfikator, lokalizację i widoczny obszar aktualnie renderowanego miejsca.
truncationPreferred
Typ:  boolean
Domyślnie: false
Jeśli ma wartość „true”, nazwa i adres miejsca są skracane, aby zmieściły się w jednym wierszu, zamiast zawijania.
Atrybut HTML:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-button-border-color
Kolor obramowania przycisku „Otwórz w Mapach”.
--gmp-button-border-radius
Promień obramowania przycisku „Otwórz w Mapach”.
--gmp-button-border-width
Szerokość obramowania przycisku „Otwórz w Mapach”.
--gmp-dialog-border-radius
Promień obramowania okna ujawniania informacji w Mapach Google.
--gmp-mat-color-info
Kolor elementów interfejsu o charakterze informacyjnym. Używany w przypadku ikony wózka inwalidzkiego.
--gmp-mat-color-negative
Kolor elementów interfejsu o negatywnym wydźwięku. Używany w tekście „Zamknięte” w stanie „Otwarte teraz”.
--gmp-mat-color-neutral-container
Kolor kontenera dla neutralnych wypełnionych elementów interfejsu. Używane w obiektach zastępczych obrazów.
--gmp-mat-color-on-secondary-container
Kolor tekstu i ikon na tle dodatkowego koloru kontenera. Używany do tekstu i ikon na przycisku „Otwórz w Mapach”.
--gmp-mat-color-on-surface
Kolor tekstu i ikon na dowolnym kolorze powierzchni. Używany do zwykłego tekstu.
--gmp-mat-color-on-surface-variant
Kolor o mniejszym nacisku dla tekstu i ikon na dowolnym kolorze powierzchni. Używany w przypadku mniej wyróżnionego tekstu.
--gmp-mat-color-outline-decorative
Kolor konturu elementów nieinteraktywnych. Używany do obramowania elementu.
--gmp-mat-color-positive
Kolor elementów interfejsu o pozytywnym wydźwięku. Używany w tekście „Otwarte” w stanie „Otwarte teraz”.
--gmp-mat-color-primary
Kolor interaktywnego tekstu i ikon na tle koloru powierzchni. Używane do określania liczby opinii, a także linków w oknie z informacjami o Mapach Google.
--gmp-mat-color-secondary-container
Mniej widoczny kolor wypełnienia na powierzchni, przeznaczony do komponentów drugorzędnych, takich jak przyciski tonalne. Używany jako tło przycisku „Otwórz w Mapach”.
--gmp-mat-color-surface
Kolor tła. Używany jako tło elementu i okna z informacjami o Mapach Google.
--gmp-mat-font-body-medium
Używany w tekście w oknie ujawniania informacji w Mapach Google.
--gmp-mat-font-body-small
Służy do wyświetlania adresu, oceny, typu, ceny i stanu otwarcia miejsca.
--gmp-mat-font-family
Podstawowa rodzina czcionek używana we wszystkich tekstach.
--gmp-mat-font-headline-medium
Używany jako tekst nagłówka w oknie ujawniania informacji w Mapach Google.
--gmp-mat-font-label-large
Używany w przypadku przycisku „Otwórz w Mapach”, a także linków w oknie ujawniania informacji w Mapach Google i tekstu informacji o pochodzeniu danych w galerii zdjęć.
--gmp-mat-font-label-medium
Używane w przypadku plakietki z liczbą zdjęć.
--gmp-mat-font-title-small
Używana jako nazwa miejsca.
--gmp-mat-spacing-extra-small
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-large
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-medium
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-small
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-star-rating-color
Kolor wypełnionych gwiazdek w ocenie.
--gmp-thumbnail-border-radius
Promień obramowania miniatury zdjęcia miejsca.
background-color
Zastępuje kolor tła elementu.
border
Zastępuje obramowanie elementu.
border-radius
Zastępuje promień obramowania elementu.
color-scheme
Wskazuje, w jakim schemacie kolorów może być renderowany ten element. Więcej informacji znajdziesz w color-scheme dokumentacji. Domyślna wartość to color-scheme: light dark.
font-size
Skaluje cały tekst i ikony w elemencie, które są zdefiniowane wewnętrznie w em. Domyślna wartość to 16px.
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
gmp-error
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy żądanie do backendu zostało odrzucone (np. nieprawidłowy klucz interfejsu API). To zdarzenie nie jest przekazywane w górę.
gmp-load
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy element wczytuje i renderuje swoją zawartość. To zdarzenie nie jest przekazywane w górę.

Interfejs PlaceDetailsCompactElementOptions

Interfejs google.maps.places.PlaceDetailsCompactElementOptions

Opcje dotyczące: PlaceDetailsCompactElement.
orientation optional
Typ:  PlaceDetailsOrientation optional
Zobacz PlaceDetailsCompactElement.orientation.
truncationPreferred optional
Typ:  boolean optional
Zobacz PlaceDetailsCompactElement.truncationPreferred.

Stałe PlaceDetailsOrientation

google.maps.places.PlaceDetailsOrientation stałe

Warianty orientacji dla: PlaceDetailsCompactElement.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceDetailsOrientation} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
HORIZONTAL Orientacja pozioma.
VERTICAL Orientacja pionowa.

PlaceDetailsPlaceRequestElement

google.maps.places.PlaceDetailsPlaceRequestElement zajęcia

Konfiguruje PlaceDetailsCompactElement lub PlaceDetailsElement, aby wczytywać dane na podstawie obiektu miejsca, identyfikatora lub nazwy zasobu. Dołącz ten element jako element podrzędny elementu PlaceDetailsCompactElement lub PlaceDetailsElement, aby wczytać dane dla określonego miejsca. Na przykład: 

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
 </gmp-place-details>

Element niestandardowy:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceDetailsPlaceRequestElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
Parametry: 
place
Typ:  Place optional
Domyślnie: null
Obiekt, identyfikator lub nazwa zasobu miejsca, którego informacje o miejscu mają być wyświetlane w kompaktowym elemencie Szczegóły miejsca. Ta właściwość odzwierciedla atrybut jako nazwę zasobu.
Atrybut HTML:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.

PlaceDetailsPlaceRequestElementOptions interface

Interfejs google.maps.places.PlaceDetailsPlaceRequestElementOptions

Opcje dotyczące: PlaceDetailsPlaceRequestElement.
place optional
Typ:  Place|string optional
Zobacz: PlaceDetailsPlaceRequestElement.place

Klasa PlaceDetailsLocationRequestElement

google.maps.places.PlaceDetailsLocationRequestElement zajęcia

Konfiguruje komponent PlaceDetailsCompactElement lub PlaceDetailsElement, aby wczytywał dane na podstawie lokalizacji. Dołącz ten element jako element podrzędny elementu PlaceDetailsCompactElement lub PlaceDetailsElement, aby wczytać dane dla określonej lokalizacji. Na przykład: 

 <gmp-place-details>
   <gmp-place-details-location-request
     location="37.6207665,-122.4284806"
   ></gmp-place-details-location-request>
 </gmp-place-details>

Element niestandardowy:
<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceDetailsLocationRequestElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
PlaceDetailsLocationRequestElement
PlaceDetailsLocationRequestElement([options])
Parametry: 
location
Domyślnie: null
Lokalizacja, dla której mają być wyświetlane informacje o miejscu w elemencie Szczegóły miejsca. Normalizuje do LatLngAltitude.
Atrybut HTML:
  • <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.

Interfejs PlaceDetailsLocationRequestElementOptions

Interfejs google.maps.places.PlaceDetailsLocationRequestElementOptions

Opcje dotyczące: PlaceDetailsLocationRequestElement.
location optional
Lokalizacja, dla której ma zostać wyrenderowane miejsce.

PlaceSearchElement

google.maps.places.PlaceSearchElement zajęcia

Wyświetla wyniki wyszukiwania miejsc na liście. Dołącz PlaceTextSearchRequestElement lub PlaceNearbySearchRequestElement, aby określić żądanie, dla którego mają zostać wyrenderowane wyniki. Dołącz PlaceContentConfigElement, PlaceStandardContentElement lub PlaceAllContentElement, aby określić, które treści mają być renderowane.

Przykład: 

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Aby używać elementu wyszukiwania miejsc, włącz w projekcie w konsoli Google Cloud interfejs Places UI Kit API.

Element niestandardowy:
<gmp-place-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceSearchElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceSearchElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
PlaceSearchElement
PlaceSearchElement([options])
Parametry: 
attributionPosition
Domyślnie: PlaceSearchAttributionPosition.TOP
Pozycja logo atrybucji i przycisku ujawnienia informacji.
Atrybut HTML:
  • <gmp-place-search attribution-position="top"></gmp-place-search>
  • <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation
Typ:  PlaceSearchOrientation optional
Domyślnie: PlaceSearchOrientation.VERTICAL
Wariant orientacji (pionowej lub poziomej) elementu.
Atrybut HTML:
  • <gmp-place-search orientation="vertical"></gmp-place-search>
  • <gmp-place-search orientation="horizontal"></gmp-place-search>
places
Typ:  Array<Place>
Tylko do odczytu. Tablica obiektów Place zawierających identyfikatory, lokalizacje i widoczne obszary obecnie renderowanych miejsc.
selectable
Typ:  boolean optional
Domyślnie: false
Określa, 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-select. Obsługiwana jest też nawigacja i wybór za pomocą klawiatury.
Atrybut HTML:
  • <gmp-place-search selectable></gmp-place-search>
truncationPreferred
Typ:  boolean optional
Domyślnie: false
Jeśli ma wartość true (prawda), skraca niektóre wiersze treści, aby zmieściły się w jednym wierszu, zamiast je zawijać.
Atrybut HTML:
  • <gmp-place-search truncation-preferred></gmp-place-search>
--gmp-button-border-color
Kolor obramowania przycisku „Otwórz w Mapach”.
--gmp-button-border-radius
Promień obramowania przycisku „Otwórz w Mapach”.
--gmp-button-border-width
Szerokość obramowania przycisku „Otwórz w Mapach”.
--gmp-card-border-radius
Promień obramowania kart miejsc.
--gmp-dialog-border-radius
Promień obramowania okna z informacjami o Mapach Google.
--gmp-mat-color-info
Kolor elementów interfejsu o charakterze informacyjnym. Używana w przypadku ikony wejścia dostępnego dla osób niepełnosprawnych.
--gmp-mat-color-negative
Kolor elementów interfejsu o negatywnym wydźwięku. Używana w etykiecie „Zamknięte” w godzinach otwarcia miejsca.
--gmp-mat-color-neutral-container
Kolor kontenera dla neutralnych wypełnionych elementów interfejsu. Używane do plakietek z datą opinii i kształtów obiektów zastępczych podczas wczytywania.
--gmp-mat-color-on-neutral-container
Kolor tekstu i ikon w neutralnym kontenerze. Służy do wyświetlania tekstu daty opinii i tekstu błędu wczytywania.
--gmp-mat-color-on-secondary-container
Kolor tekstu i ikon na tle koloru kontenera dodatkowego. Używany do tekstu i ikon przycisków.
--gmp-mat-color-on-surface
Kolor tekstu i ikon na tle koloru powierzchni. Używany w nagłówkach i treściach okien.
--gmp-mat-color-on-surface-variant
Kolor o mniejszym nacisku dla tekstu i ikon na tle koloru powierzchni. Używany do informacji o miejscu.
--gmp-mat-color-outline-decorative
Kolor konturu elementów nieinteraktywnych. Używany do obramowania kontenera.
--gmp-mat-color-positive
Kolor elementów interfejsu o pozytywnym wydźwięku. Używana w etykiecie „Otwarte” w godzinach otwarcia miejsca.
--gmp-mat-color-primary
Kolor interaktywnego tekstu i ikon na tle koloru powierzchni. Używany w linkach, wskaźniku ładowania i ikonach przeglądu.
--gmp-mat-color-secondary-container
Mniej widoczny kolor wypełnienia na powierzchni. Używany w tle przycisków.
--gmp-mat-color-surface
Kolor tła. Używany jako tło kontenerów i okien.
--gmp-mat-font-body-small
Używany do informacji o miejscu.
--gmp-mat-font-family
Podstawowa rodzina czcionek dla całego tekstu.
--gmp-mat-font-headline-medium
Służy do nagłówków okien.
--gmp-mat-font-label-large
Służy do określania treści przycisku.
--gmp-mat-font-title-medium
Używana jako nazwa miejsca.
--gmp-mat-spacing-extra-small
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-large
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-medium
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-mat-spacing-small
Służy do określania odstępów wewnątrz elementu, takich jak margines i dopełnienie wokół tekstu.
--gmp-star-rating-color
Kolor wypełnionych gwiazdek w ocenie w gwiazdkach.
--gmp-thumbnail-border-radius
Promień obramowania miniatury miejsca.
background-color
Zastępuje kolor tła elementu.
border
Zastępuje obramowanie elementu.
border-radius
Zastępuje promień obramowania elementu.
color-scheme
Wskazuje, w jakim schemacie kolorów może być renderowany ten element. Więcej informacji znajdziesz w color-scheme dokumentacji. Domyślna wartość to color-scheme: light dark.
font-size
Skaluje cały tekst i ikony w elemencie. Domyślna wartość to 16px.
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
gmp-error
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy żądanie do backendu zostało odrzucone (np. nieprawidłowy klucz interfejsu API). To zdarzenie nie jest przekazywane w górę.
gmp-load
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy element wczytuje i renderuje swoją zawartość. To zdarzenie nie jest przekazywane w górę.
gmp-select
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy miejsce zostanie wybrane z listy. Zawiera obiekt Place z identyfikatorem, lokalizacją i obszarem roboczym wybranego miejsca.

PlaceSearchElementOptions

Interfejs google.maps.places.PlaceSearchElementOptions

Opcje dotyczące: PlaceSearchElement.
attributionPosition optional
Zobacz PlaceSearchElement.attributionPosition.
orientation optional
Typ:  PlaceSearchOrientation optional
Zobacz PlaceSearchElement.orientation.
selectable optional
Typ:  boolean optional
Zobacz: PlaceSearchElement.selectable
truncationPreferred optional
Typ:  boolean optional
Zobacz PlaceSearchElement.truncationPreferred.

PlaceSearchAttributionPosition constants

google.maps.places.PlaceSearchAttributionPosition stałe

Pozycje atrybucji dla: PlaceSearchElement.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
BOTTOM Atrybucja u dołu elementu PlaceSearchElement
TOP Atrybucja u góry elementu PlaceSearchElement

PlaceSearchOrientation – stałe

google.maps.places.PlaceSearchOrientation stałe

Warianty orientacji dla: PlaceSearchElement.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceSearchOrientation} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
HORIZONTAL Orientacja pozioma.
VERTICAL Orientacja pionowa.

Klasa PlaceSelectEvent

google.maps.places.PlaceSelectEvent zajęcia

To zdarzenie jest wywoływane, gdy użytkownik wybierze miejsce z listy miejsc. Aby uzyskać dostęp do wyboru, naciśnij event.place.

Ta klasa rozszerza klasę Event.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceSelectEvent} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
place
Typ:  Place
wybrane miejsce,

Klasa PlaceNearbySearchRequestElement

google.maps.places.PlaceNearbySearchRequestElement zajęcia

Konfiguruje PlaceSearchElement, aby wczytywać wyniki na podstawie żądania wyszukiwania w pobliżu. Właściwość locationRestriction jest wymagana do wczytania elementu wyszukiwania. Jeśli właściwość locationRestriction nie jest ustawiona, wszystkie inne skonfigurowane właściwości zostaną zignorowane. Aby wczytać wyniki, dołącz ten element jako element podrzędny elementu PlaceSearchElement. Na przykład: 

 <gmp-place-search>
   <gmp-place-nearby-search-request
     location-restriction="RADIUS@LAT,LNG"
   ></gmp-place-nearby-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Element niestandardowy:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceNearbySearchRequestElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
Parametry: 
excludedPrimaryTypes
Typ:  Array<string> optional
Domyślnie: null
Wykluczone typy miejsc głównych.
Atrybut HTML:
  • <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes
Typ:  Array<string> optional
Domyślnie: null
Wykluczone typy miejsc.
Atrybut HTML:
  • <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes
Typ:  Array<string> optional
Domyślnie: null
Uwzględniony główny typ miejsca.
Atrybut HTML:
  • <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes
Typ:  Array<string> optional
Domyślnie: null
Uwzględniony typ miejsca.
Atrybut HTML:
  • <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction
Typ:  Circle|CircleLiteral optional
Domyślnie: null
Region, w którym ma zostać przeprowadzone wyszukiwanie. Normalizuje do Circle.
Atrybut HTML:
  • <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount
Typ:  number optional
Domyślnie: null
Maksymalna liczba wyników do zwrócenia.
Atrybut HTML:
  • <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference
Domyślnie: null
Sposób, w jaki wyniki będą klasyfikowane w odpowiedzi.
Atrybut HTML:
  • <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.

PlaceNearbySearchRequestElementOptions interface

Interfejs google.maps.places.PlaceNearbySearchRequestElementOptions

Opcje dotyczące: PlaceNearbySearchRequestElement.
excludedPrimaryTypes optional
Typ:  Array<string> optional
Wykluczone typy miejsc głównych. Więcej informacji znajdziesz w PlaceNearbySearchRequestElement.excludedPrimaryTypes i SearchNearbyRequest.excludedPrimaryTypes.
excludedTypes optional
Typ:  Array<string> optional
Wykluczone typy miejsc. Więcej informacji znajdziesz w PlaceNearbySearchRequestElement.excludedTypes i SearchNearbyRequest.excludedTypes.
includedPrimaryTypes optional
Typ:  Array<string> optional
Uwzględnione typy miejsc głównych. Więcej informacji znajdziesz w PlaceNearbySearchRequestElement.includedPrimaryTypes i SearchNearbyRequest.includedPrimaryTypes.
includedTypes optional
Typ:  Array<string> optional
Uwzględnione typy miejsc. Więcej informacji znajdziesz w PlaceNearbySearchRequestElement.includedTypes i SearchNearbyRequest.includedTypes.
locationRestriction optional
Typ:  Circle|CircleLiteral optional
Region, w którym ma zostać przeprowadzone wyszukiwanie. Więcej informacji znajdziesz w PlaceNearbySearchRequestElement.locationRestriction i SearchNearbyRequest.locationRestriction.
maxResultCount optional
Typ:  number optional
Maksymalna liczba wyników do zwrócenia. Więcej informacji znajdziesz w PlaceNearbySearchRequestElement.maxResultCount i SearchNearbyRequest.maxResultCount.
rankPreference optional
Sposób, w jaki wyniki będą klasyfikowane w odpowiedzi. Więcej informacji znajdziesz w PlaceNearbySearchRequestElement.rankPreference i SearchNearbyRankPreference.

PlaceTextSearchRequestElement class

google.maps.places.PlaceTextSearchRequestElement zajęcia

Konfiguruje PlaceSearchElement, aby wczytywać wyniki na podstawie żądania wyszukiwania tekstu. Właściwość textQuery jest wymagana do wczytania elementu wyszukiwania. Jeśli właściwość textQuery nie jest ustawiona, wszystkie inne skonfigurowane właściwości zostaną zignorowane. Aby wczytać wyniki, dołącz ten element jako element podrzędny elementu PlaceSearchElement. Na przykład: 

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Element niestandardowy:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceTextSearchRequestElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
Parametry: 
evConnectorTypes
Typ:  Array<EVConnectorType> optional
Domyślnie: null
Lista preferowanych typów złączy EV.
Atrybut HTML:
  • <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw
Typ:  number optional
Domyślnie: null
Minimalna wymagana moc ładowania w kilowatach.
Atrybut HTML:
  • <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType
Typ:  string optional
Domyślnie: null
Żądany typ miejsca.
Atrybut HTML:
  • <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow
Typ:  boolean optional
Domyślnie: null
Służy do ograniczania wyszukiwania do miejsc, które są obecnie otwarte.
Atrybut HTML:
  • <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias
Typ:  LocationBias optional
Domyślnie: null
Ustawienie lokalizacji na potrzeby wyszukiwania. Normalizuje do LatLngAltitude | LatLngBounds | Circle | string.
Atrybut HTML:
  • <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction
Domyślnie: null
Ograniczenie lokalizacji wyszukiwania. Normalizuje do LatLngBounds.
Atrybut HTML:
  • <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount
Typ:  number optional
Domyślnie: null
Maksymalna liczba wyników do zwrócenia.
Atrybut HTML:
  • <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating
Typ:  number optional
Domyślnie: null
Odfiltruj wyniki, których średnia ocena użytkowników jest niższa niż ten limit.
Atrybut HTML:
  • <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels
Typ:  Array<PriceLevel> optional
Domyślnie: null
Służy do ograniczania wyszukiwania do miejsc oznaczonych określonymi poziomami cen.
Atrybut HTML:
  • <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference
Domyślnie: null
Sposób, w jaki wyniki będą klasyfikowane w odpowiedzi.
Atrybut HTML:
  • <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery
Typ:  string optional
Domyślnie: null
Zapytanie tekstowe do wyszukiwania tekstowego.
Atrybut HTML:
  • <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering
Typ:  boolean optional
Domyślnie: null
Służy do ustawiania rygorystycznego filtrowania typów dla parametru „includedType”.
Atrybut HTML:
  • <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.

PlaceTextSearchRequestElementOptions interface

Interfejs google.maps.places.PlaceTextSearchRequestElementOptions

Opcje dotyczące: PlaceTextSearchRequestElement.
evConnectorTypes optional
Typ:  Array<EVConnectorType> optional
Lista preferowanych typów złączy EV. Więcej informacji znajdziesz w SearchByTextRequest.evSearchOptions i PlaceTextSearchRequestElement.evConnectorTypes.
evMinimumChargingRateKw optional
Typ:  number optional
Minimalna wymagana moc ładowania w kilowatach. Więcej informacji znajdziesz w SearchByTextRequest.evSearchOptions i PlaceTextSearchRequestElement.evMinimumChargingRateKw.
includedType optional
Typ:  string optional
Żądany typ miejsca. Więcej informacji znajdziesz w SearchByTextRequest.includedType i PlaceTextSearchRequestElement.includedType.
isOpenNow optional
Typ:  boolean optional
Służy do ograniczania wyszukiwania do miejsc, które są obecnie otwarte. Więcej informacji znajdziesz w SearchByTextRequest.isOpenNow i PlaceTextSearchRequestElement.isOpenNow.
locationBias optional
Typ:  LocationBias optional
Ustawienie lokalizacji na potrzeby wyszukiwania. Więcej informacji znajdziesz w SearchByTextRequest.locationBias i PlaceTextSearchRequestElement.locationBias.
locationRestriction optional
Ograniczenie lokalizacji wyszukiwania. Więcej informacji znajdziesz w SearchByTextRequest.locationRestriction i PlaceTextSearchRequestElement.locationRestriction.
maxResultCount optional
Typ:  number optional
Maksymalna liczba wyników do zwrócenia. Więcej informacji znajdziesz w SearchByTextRequest.maxResultCount i PlaceTextSearchRequestElement.maxResultCount.
minRating optional
Typ:  number optional
Odfiltruj wyniki, których średnia ocena użytkowników jest niższa niż ten limit. Więcej informacji znajdziesz w SearchByTextRequest.minRating i PlaceTextSearchRequestElement.minRating.
priceLevels optional
Typ:  Array<PriceLevel> optional
Służy do ograniczania wyszukiwania do miejsc oznaczonych określonymi poziomami cen. Więcej informacji znajdziesz w SearchByTextRequest.priceLevels i PlaceTextSearchRequestElement.priceLevels.
rankPreference optional
Sposób, w jaki wyniki będą klasyfikowane w odpowiedzi. Więcej informacji znajdziesz w SearchByTextRequest.rankPreference i PlaceTextSearchRequestElement.rankPreference.
textQuery optional
Typ:  string optional
Zapytanie tekstowe do wyszukiwania tekstowego. Więcej informacji znajdziesz w SearchByTextRequest.textQuery i PlaceTextSearchRequestElement.textQuery.
useStrictTypeFiltering optional
Typ:  boolean optional
Służy do ustawiania rygorystycznego filtrowania typów dla SearchByTextRequest.includedType. Więcej informacji znajdziesz w SearchByTextRequest.useStrictTypeFiltering i PlaceTextSearchRequestElement.useStrictTypeFiltering.

Klasa Autocomplete

google.maps.places.Autocomplete zajęcia

Widżet, który wyświetla podpowiedzi miejsc na podstawie tekstu wpisanego przez użytkownika. Dołącza się do elementu wejściowego typu text i nasłuchuje wpisywania tekstu w tym polu. Lista podpowiedzi jest wyświetlana jako lista rozwijana i jest aktualizowana podczas wpisywania tekstu.

Ta klasa rozszerza klasę MVCObject.

Aby uzyskać dostęp, zadzwoń 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 granice, do których podpowiedzi są ukierunkowane.
getFields
getFields()
Parametry: brak
Wartość zwracana:  Array<string>|undefined
Zwraca pola, które mają zostać uwzględnione w odpowiedzi ze szczegółami miejsca, gdy szczegóły zostaną pomyślnie pobrane. Listę pól znajdziesz w artykule 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 pomyślnie pobrane. W przeciwnym razie zwraca obiekt 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, 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 komponentów służą do ograniczania podpowiedzi 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
Ustawia pola, które mają być uwzględnione w odpowiedzi ze szczegółami miejsca, gdy szczegóły zostaną pomyślnie pobrane. Listę pól znajdziesz w artykule PlaceResult.
setOptions
setOptions(options)
Parametry: 
Zwracana wartość: brak
setTypes
setTypes(types)
Parametry: 
  • types:  Array<string> optional typy podpowiedzi, które mają być uwzględniane.
Zwracana wartość: brak
Określa typy podpowiedzi, które mają być zwracane. Obsługiwane typy znajdziesz w  przewodniku dla deweloperów. Jeśli nie określisz żadnych typów, zostaną zwrócone wszystkie typy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy PlaceResult jest dostępny w miejscu wybranym przez użytkownika.
Jeśli użytkownik wpisze nazwę miejsca, która nie została zasugerowana przez element sterujący, i naciśnie klawisz Enter lub jeśli żądanie informacji o miejscu się nie powiedzie, obiekt PlaceResult będzie zawierać dane wejściowe użytkownika we właściwości name, bez innych zdefiniowanych właściwości.

AutocompleteOptions interface

Interfejs google.maps.places.AutocompleteOptions

Opcje, które można ustawić w obiekcie Autocomplete.
bounds optional
Obszar, na którym chcesz wyszukać miejsca.
componentRestrictions optional
Typ:  ComponentRestrictions optional
Ograniczenia dotyczące komponentu. Ograniczenia komponentów służą do ograniczania podpowiedzi 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, gdy szczegóły zostaną pobrane, za które zostanie naliczona opłata. Jeśli podasz wartość ['ALL'], zostaną zwrócone wszystkie dostępne pola i zostaną za nie naliczone opłaty (nie zalecamy tego w przypadku wdrożeń produkcyjnych). Listę pól znajdziesz w artykule 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 pobierać tylko identyfikatory miejsc. Obiekt PlaceResult udostępniany po wywołaniu zdarzenia place_changed będzie zawierał tylko pola identyfikator miejsca, types i name, a pola identyfikator miejsca, types i description będą zwracane przez usługę autouzupełniania. Domyślnie 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 granicach widżetu autouzupełniania w momencie wysyłania zapytania. Ustawienie parametru strictBounds na wartość false (która jest wartością domyślną) spowoduje, że wyniki będą faworyzować miejsca znajdujące się w granicach, ale nie będą ograniczone tylko do nich.
types optional
Typ:  Array<string> optional
Typy podpowiedzi, które mają być zwracane. Obsługiwane typy znajdziesz w  przewodniku dla deweloperów. Jeśli nie określisz żadnych typów, zostaną zwrócone wszystkie typy.

google.maps.places.SearchBox zajęcia

Widżet, który wyświetla podpowiedzi na podstawie tekstu wpisanego przez użytkownika. Dołącza się do elementu wejściowego typu text i nasłuchuje wpisywania tekstu w tym polu. Lista podpowiedzi jest wyświetlana jako lista rozwijana i jest aktualizowana podczas wpisywania tekstu.

Ta klasa rozszerza klasę MVCObject.

Aby uzyskać dostęp, zadzwoń 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
Wartość zwracana:  LatLngBounds|undefined
Zwraca granice, do których są kierowane podpowiedzi zapytania.
getPlaces
getPlaces()
Parametry: brak
Wartość zwracana:  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 dostosowywania podpowiedzi do zapytań. Wyniki będą tylko faworyzować ten obszar, a nie będą całkowicie do niego ograniczone.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy użytkownik wybierze zapytanie. Do pobierania nowych miejsc należy używać getPlaces.

Interfejs SearchBoxOptions

Interfejs google.maps.places.SearchBoxOptions

Opcje, które można ustawić w obiekcie SearchBox.
bounds optional
Obszar, na który mają być ukierunkowane podpowiedzi do zapytania. Podpowiedzi są ukierunkowane na zapytania dotyczące tych granic, ale nie są do nich ograniczone.

PlaceContextualElement

google.maps.places.PlaceContextualElement zajęcia

Widżet, który używa tokena kontekstowego do wyświetlania widoku kontekstowego odpowiedzi z powiązania ze źródłami informacji przy użyciu Map Google.

Element niestandardowy:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceContextualElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceContextualElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
PlaceContextualElement
PlaceContextualElement([options])
Parametry: 
contextToken
Typ:  string optional
Token kontekstowy.
Atrybut HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.

PlaceContextualElementOptions interface

Interfejs google.maps.places.PlaceContextualElementOptions

Opcje dotyczące: PlaceContextualElement.
contextToken optional
Typ:  string optional
Token kontekstowy dostarczany przez odpowiedź funkcji powiązania ze źródłami informacji przy użyciu Map Google.

PlaceContextualListConfigElement class

google.maps.places.PlaceContextualListConfigElement zajęcia

Element HTML, który konfiguruje opcje widoku listy elementu kontekstowego miejsca.

Element niestandardowy:
<gmp-place-contextual-list-config layout="compact" map-hidden></gmp-place-contextual-list-config>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PlaceContextualListConfigElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
Parametry: 
layout
Układ.
Atrybut HTML:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
Typ:  boolean optional
Czy mapa jest ukryta.
Atrybut HTML:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • type:  string ciąg znaków (z uwzględnieniem wielkości liter) reprezentujący typ zdarzenia, które ma być nasłuchiwane.
  • 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 te parametry: capture i passive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener.
removeEventListener
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 elementu docelowego zdarzenia.
  • options:  boolean|EventListenerOptions optional Zobacz opcje.
Wartość zwracana:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.

Interfejs PlaceContextualListConfigElementOptions

Interfejs google.maps.places.PlaceContextualListConfigElementOptions

Opcje elementu PlaceContextualListConfigElement.
layout optional
Domyślnie: PlaceContextualListLayout.VERTICAL
Układ.
mapHidden optional
Typ:  boolean optional
Domyślnie: false
Prawda, jeśli mapa ma być ukryta.

Stałe PlaceContextualListLayout

google.maps.places.PlaceContextualListLayout stałe

Lista układów obsługiwanych przez element kontekstowy miejsca w widoku listy.

Aby uzyskać dostęp, zadzwoń pod numer const {PlaceContextualListLayout} = await google.maps.importLibrary("places").
Zobacz Biblioteki w Maps JavaScript API.
COMPACT Kompaktowy układ listy: elementy listy są renderowane jako linki w jednym wierszu, a elementy, które się nie mieszczą, są wyświetlane na rozwijanej liście.
VERTICAL Układ listy pionowej: elementy listy są renderowane jako karty na liście pionowej.