Advanced Markers

AdvancedMarkerElement class

google.maps.marker.AdvancedMarkerElement zajęcia

Wyświetla pozycję na mapie. Pamiętaj, że aby wyświetlić AdvancedMarkerElement, musisz ustawić position.

Element niestandardowy:
<gmp-advanced-marker gmp-clickable position="lat,lng" title="string"></gmp-advanced-marker>

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs AdvancedMarkerElementOptions.

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

AdvancedMarkerElement
AdvancedMarkerElement([options])
Parametry: 
Tworzy element AdvancedMarkerElement z określonymi opcjami. Jeśli mapa jest określona, AdvancedMarkerElement jest dodawany do mapy po utworzeniu.
collisionBehavior
Typ:  CollisionBehavior optional
gmpClickable
Typ:  boolean optional
Atrybut HTML:
  • <gmp-advanced-marker gmp-clickable></gmp-advanced-marker>
gmpDraggable
Typ:  boolean optional
map
Typ:  Map optional
position
Atrybut HTML:
  • <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker>
  • <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title
Typ:  string
Atrybut HTML:
  • <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex
Typ:  number optional
element
To pole jest tylko do odczytu. Element DOM, który jest podstawą widoku.
content
Typ:  Node optional
addEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring Ciąg znaków z uwzględnieniem wielkości liter reprezentujący typ zdarzenia, którego chcesz nasłuchiwać.
  • listenerEventListener|EventListenerObject obiekt, który otrzymuje powiadomienie; Musi to być funkcja lub obiekt z metodą handleEvent.
  • optionsboolean|AddEventListenerOptions optional zobacz opcje. Zdarzenia niestandardowe obsługują tylko capturepassive.
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
addListener
addListener(eventName, handler)
Parametry: 
  • eventNamestring zarejestrowane zdarzenie.
  • handlerFunction Funkcja obsługi zdarzeń.
Zwracana wartość:  MapsEventListener wynikowy detektor zdarzeń.
Dodaje podaną funkcję detektora do podanej nazwy zdarzenia w systemie zdarzeń Map Google.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków określający typ zdarzenia, dla którego ma zostać usunięty detektor zdarzeń.
  • listenerEventListener|EventListenerObject Detektor zdarzeń modułu obsługi zdarzeń, który ma zostać usunięty z obiektu docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zobacz opcje.
Zwracana wartość:  void
Usuwa z obiektu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.
click
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu elementu AdvancedMarkerElement.

Niedostępne w przypadku addEventListener() (zamiast tego użyj gmp-click).
drag
function(event)
Argumenty: 
To zdarzenie jest wywoływane wielokrotnie, gdy użytkownik przeciąga element AdvancedMarkerElement.

Niedostępne w przypadku addEventListener().
dragend
function(event)
Argumenty: 
To zdarzenie jest uruchamiane, gdy użytkownik przestanie przeciągać element AdvancedMarkerElement.

Niedostępne w przypadku addEventListener().
dragstart
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik zaczyna przeciągać element AdvancedMarkerElement.

Niedostępne w przypadku addEventListener().
Betagmp-click
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu elementu AdvancedMarkerElement. Najlepiej używać z zasadą addEventListener() (zamiast addListener()).

AdvancedMarkerElementOptions interfejs

google.maps.marker.AdvancedMarkerElementOptionsinterfejs

Opcje tworzenia AdvancedMarkerElement.

collisionBehavior optional
Typ:  CollisionBehavior optional
Wyliczenie określające, jak element AdvancedMarkerElement powinien się zachowywać, gdy koliduje z innym elementem AdvancedMarkerElement lub z etykietami mapy bazowej na mapie wektorowej.

Uwaga: kolizja AdvancedMarkerElementAdvancedMarkerElement działa zarówno na mapach rastrowych, jak i wektorowych, ale kolizja AdvancedMarkerElement z etykietą mapy bazowej działa tylko na mapach wektorowych.

content optional
Typ:  Node optional
Domyślnie: PinElement.element
Element DOM, który stanowi podstawę wizualną elementu AdvancedMarkerElement.

Uwaga: funkcja AdvancedMarkerElement nie klonuje przekazanego elementu DOM. Gdy element DOM zostanie przekazany do komponentu AdvancedMarkerElement, przekazanie tego samego elementu DOM do innego komponentu AdvancedMarkerElement spowoduje przeniesienie elementu DOM i wyświetlenie poprzedniego komponentu AdvancedMarkerElement jako pustego.

BetagmpClickable optional
Typ:  boolean optional
Domyślnie: false
Jeśli wartość parametru true to „true”, element AdvancedMarkerElement będzie klikalny i wywoła zdarzenie gmp-click, a także będzie interaktywny na potrzeby ułatwień dostępu (np. umożliwi nawigację za pomocą klawiatury przy użyciu klawiszy strzałek).
gmpDraggable optional
Typ:  boolean optional
Domyślnie: false
Jeśli true, element AdvancedMarkerElement można przeciągnąć.

Uwaga: element AdvancedMarkerElement z wysokością nie jest przesuwalny.

map optional
Typ:  Map optional
Mapa, na której ma być wyświetlana wartość AdvancedMarkerElement. Mapa jest wymagana do wyświetlania elementu AdvancedMarkerElement i może być dostarczona przez ustawienie AdvancedMarkerElement.map, jeśli nie została podana podczas tworzenia.
position optional
Ustawia pozycję AdvancedMarkerElement. AdvancedMarkerElement można utworzyć bez pozycji, ale nie będzie się wyświetlać, dopóki nie zostanie ona podana, np. w wyniku działań lub wyborów użytkownika. Pozycję elementu AdvancedMarkerElement można podać, ustawiając wartość AdvancedMarkerElement.position, jeśli nie została ona podana podczas tworzenia.

Uwaga: AdvancedMarkerElement z wysokością jest obsługiwane tylko na mapach wektorowych.

title optional
Typ:  string optional
Tekst po najechaniu kursorem. Jeśli podano tekst ułatwień dostępu (np. do użycia z czytnikami ekranu), zostanie on dodany do elementu AdvancedMarkerElement z podaną wartością.
zIndex optional
Typ:  number optional
Wszystkie AdvancedMarkerElement są wyświetlane na mapie w kolejności określonej przez parametr zIndex. Elementy o wyższych wartościach są wyświetlane przed elementami o niższych wartościach.AdvancedMarkerElement Domyślnie AdvancedMarkerElement są wyświetlane zgodnie z ich pionową pozycją na ekranie, przy czym AdvancedMarkerElement znajdujące się niżej na ekranie pojawiają się przed AdvancedMarkerElement znajdującymi się wyżej. Pamiętaj, że zIndex służy też do określania względnego priorytetu między CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY zaawansowanymi znacznikami. Wyższa wartość zIndex oznacza wyższy priorytet.

Klasa AdvancedMarkerClickEvent

google.maps.marker.AdvancedMarkerClickEvent zajęcia

To zdarzenie jest tworzone po kliknięciu zaawansowanego markera. Dostęp do pozycji znacznika uzyskasz za pomocą metody event.target.position.

Ta klasa rozszerza klasę Event.

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

PinElement class

google.maps.marker.PinElement zajęcia

Symbol PinElement reprezentuje element DOM, który składa się z kształtu i glifu. Kształt ma taki sam styl dymka jak domyślny symbol AdvancedMarkerElement. Glif to opcjonalny element DOM wyświetlany w balonie. PinElement może mieć inny współczynnik proporcji w zależności od PinElement.scale.

Uwaga: używanie jako komponentu internetowego (np. jako podklasy HTMLElement lub za pomocą HTML) nie jest jeszcze obsługiwane.

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PinElementOptions.

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

PinElement
PinElement([options])
Parametry: 
background
Typ:  string optional
borderColor
Typ:  string optional
element
To pole jest tylko do odczytu. Element DOM, który jest podstawą widoku.
glyph
Typ:  string|Element|URL optional
glyphColor
Typ:  string optional
scale
Typ:  number optional
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
Zwracana wartość:  void
Ta funkcja nie jest jeszcze dostępna.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków określający typ zdarzenia, dla którego ma zostać usunięty detektor zdarzeń.
  • listenerEventListener|EventListenerObject Detektor zdarzeń modułu obsługi zdarzeń, który ma zostać usunięty z obiektu docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zobacz opcje.
Zwracana wartość:  void
Usuwa z obiektu docelowego detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Zobacz removeEventListener.

PinElementOptions interfejs

google.maps.marker.PinElementOptionsinterfejs

Opcje tworzenia PinElement.

background optional
Typ:  string optional
Kolor tła kształtu pinezki. Obsługuje dowolną wartość koloru CSS.
borderColor optional
Typ:  string optional
Kolor obramowania kształtu pinezki. Obsługuje dowolną wartość koloru CSS.
glyph optional
Typ:  string|Element|URL optional
Element DOM wyświetlany w przypiętym elemencie.
glyphColor optional
Typ:  string optional
Kolor glifu. Obsługuje dowolną wartość koloru CSS.
scale optional
Typ:  number optional
Domyślnie: 1
Skala pinezki.