Advanced Markers

AdvancedMarkerElement class

google.maps.marker.AdvancedMarkerElement class

Wyświetla pozycję na mapie. Pamiętaj, że aby opcja AdvancedMarkerElement była widoczna, musisz ustawić opcję position.

Uwaga: komponenty internetowe (np. niestandardowy element HTML <gmp-advanced-marker>) są dostępne tylko w kanale v=beta.

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

Te zajęcia trwają HTMLElement.

Ta klasa implementuje AdvancedMarkerElementOptions.

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

AdvancedMarkerElement
AdvancedMarkerElement([options])
Parametry: 
Tworzy AdvancedMarkerElement z określonymi opcjami. Jeśli mapa została określona, AdvancedMarkerElement zostanie dodana do mapy po zakończeniu budowy.
collisionBehavior
Typ:  CollisionBehavior optional
content
Typ:  Node optional
element
To pole jest tylko do odczytu. Element DOM obsługujący widok.
BetagmpClickable
Typ:  boolean optional
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
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg znaków uwzględniający wielkość liter, który reprezentuje typ zdarzenia do nasłuchiwania.
  • listenerEventListener|EventListenerObject Obiekt, który odbiera powiadomienie. Musi to być funkcja lub obiekt z metodą handleEvent
  • optionsboolean|AddEventListenerOptions optional patrz opcje. Zdarzenia niestandardowe obsługują tylko capturepassive.
Wartość zwracana:  void
Konfiguruje funkcję, która będzie wywoływana, gdy określone zdarzenie zostanie dostarczone do celu. Zobacz addEventListener
addListener
addListener(eventName, handler)
Parametry: 
  • eventNamestring Zaobserwowane zdarzenie.
  • handlerFunction funkcja do obsługi zdarzeń.
Zwracana wartość:  MapsEventListener detektor zdarzenia.
Dodaje funkcję detektora do podanej nazwy zdarzenia w systemie zdarzeń Map Google.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestringCiąg znaków określający typ zdarzenia, dla którego ma zostać usunięty dekoder zdarzenia.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Wartość zwracana:  void
Usuwa z docelowego elementu detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Patrz 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 wielokrotnie wywoływane, gdy użytkownik przeciąga element AdvancedMarkerElement.

Niedostępne w przypadku addEventListener().
dragend
function(event)
Argumenty: 
To zdarzenie jest wywoływane, 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 zacznie 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ć go z wartością addEventListener() (zamiast addListener()).

Interfejs AdvancedMarkerElementOptions

google.maps.marker.AdvancedMarkerElementOptionsinterfejs

Opcje tworzenia AdvancedMarkerElement.

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

Uwaga: kolizja AdvancedMarkerElementAdvancedMarkerElement działa zarówno w przypadku map rastrowych, jak i wektorowch, ale kolizja etykiety AdvancedMarkerElement z mapą podstawową działa tylko w przypadku map wektorowych.

content optional
Typ:  Node optional
Domyślnie: PinElement.element
Element DOM obsługujący wizualizację AdvancedMarkerElement.

Uwaga: funkcja AdvancedMarkerElement nie klonuje przekazanego elementu DOM. Gdy element DOM zostanie przekazany do AdvancedMarkerElement, przekazanie tego samego elementu DOM do innego AdvancedMarkerElement spowoduje przeniesienie elementu DOM i uczyni, że poprzedni AdvancedMarkerElement będzie wyglądać na pusty.

BetagmpClickable optional
Typ:  boolean optional
Domyślnie: false
Jeśli true, element AdvancedMarkerElement będzie klikalny i będzie wywoływać zdarzenie gmp-click.Będzie też interaktywny w celu ułatwienia dostępu (np. umożliwiając nawigację za pomocą klawiszy strzałek).
gmpDraggable optional
Typ:  boolean optional
Domyślnie: false
Jeśli true, można przeciągać AdvancedMarkerElement.

Uwaga: AdvancedMarkerElement z wysokością nie można przeciągać.

map optional
Typ:  Map optional
Mapa, na której ma być wyświetlana AdvancedMarkerElement. Mapa jest wymagana do wyświetlania AdvancedMarkerElement i może być podana przez ustawienie AdvancedMarkerElement.map, jeśli nie została podana podczas tworzenia.
position optional
Ustawia pozycję AdvancedMarkerElement. Element AdvancedMarkerElement może być utworzony bez pozycji, ale nie będzie wyświetlany, dopóki nie zostanie określona jego pozycja – np. przez działania lub wybory użytkownika. Pozycję AdvancedMarkerElement można określić, ustawiając parametr 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 najechania kursorem. Jeśli zostanie podany, tekst ułatwień dostępu (np. do użycia z czytnikami ekranu) zostanie dodany do elementu AdvancedMarkerElement z podaną wartością.
zIndex optional
Typ:  number optional
Wszystkie AdvancedMarkerElement są wyświetlane na mapie w kolejności ich zIndex, przy czym wyższe wartości są wyświetlane przed AdvancedMarkerElement o niższych wartościach. Domyślnie AdvancedMarkerElement są wyświetlane zgodnie z ich pozycją pionową na ekranie, a niższe AdvancedMarkerElement są wyświetlane przed AdvancedMarkerElement znajdującymi się wyżej na ekranie. 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.

AdvancedMarkerClickEvent class

google.maps.marker.AdvancedMarkerClickEvent class

To zdarzenie jest tworzone po kliknięciu znacznika zaawansowanego. Aby uzyskać dostęp do pozycji znacznika, kliknij event.target.position.

Te zajęcia trwają Event.

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

Klasa PinElement

google.maps.marker.PinElement class

Element PinElement reprezentuje element DOM, który składa się z kształtu i glifu. Kształt ma ten sam styl okienka co domyślny AdvancedMarkerElement. Glify to opcjonalne elementy DOM wyświetlane w kształcie baloników. PinElement może mieć inny format obrazu w zależności od PinElement.scale.

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

Te zajęcia trwają HTMLElement.

Ta klasa implementuje PinElementOptions.

Dostęp przez połączenie telefoniczne 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 obsługujący widok.
glyph
Typ:  string|Element|URL optional
glyphColor
Typ:  string optional
scale
Typ:  number optional
BetaaddEventListener
addEventListener(type, listener[, options])
Parametry: 
Wartość zwracana:  void
Ta funkcja nie jest jeszcze dostępna.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestringCiąg znaków określający typ zdarzenia, dla którego ma zostać usunięty dekoder zdarzenia.
  • listenerEventListener|EventListenerObject Detektor zdarzenia modułu obsługi, który ma zostać usunięty z docelowego zdarzenia.
  • optionsboolean|EventListenerOptions optional zob. opcje
Wartość zwracana:  void
Usuwa z docelowego elementu detektor zdarzeń zarejestrowany wcześniej za pomocą metody addEventListener. Patrz removeEventListener

Interfejs PinElementOptions

google.maps.marker.PinElementOptionsinterfejs

Opcje tworzenia PinElement.

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