Advanced Markers

Klasa AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement zajęcia

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

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

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs AdvancedMarkerElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer 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 jest określona, AdvancedMarkerElement jest dodawany do mapy podczas tworzenia.
anchorLeft
Typ:  string optional
Domyślnie: „-50%”
Wartość długości i procentu w CSS, która służy do przesunięcia punktu zakotwiczenia znacznika względem jego lewego górnego rogu. Jest to przydatne, gdy używasz elementu wizualnego, który ma punkt zakotwiczenia inny niż typowy dolny środkowy punkt domyślnego znacznika.
Atrybut HTML:
  • <gmp-advanced-marker anchor-left="string"></gmp-advanced-marker>
anchorTop
Typ:  string optional
Domyślnie: „-100%”
Wartość długości i procentu w CSS, która służy do przesunięcia punktu zakotwiczenia znacznika względem jego lewego górnego rogu. Jest to przydatne, gdy używasz elementu wizualnego, który ma punkt zakotwiczenia inny niż typowy dolny środkowy punkt domyślnego znacznika.
Atrybut HTML:
  • <gmp-advanced-marker anchor-top="string"></gmp-advanced-marker>
collisionBehavior
Typ:  CollisionBehavior optional
Zobacz AdvancedMarkerElementOptions.collisionBehavior.
gmpClickable
Typ:  boolean optional
Zobacz AdvancedMarkerElementOptions.gmpClickable.
Atrybut HTML:
  • <gmp-advanced-marker gmp-clickable></gmp-advanced-marker>
gmpDraggable
Typ:  boolean optional
Zobacz AdvancedMarkerElementOptions.gmpDraggable.
map
Typ:  Map optional
Zobacz AdvancedMarkerElementOptions.map.
position
Zobacz AdvancedMarkerElementOptions.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
Zobacz AdvancedMarkerElementOptions.title.
Atrybut HTML:
  • <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex
Typ:  number optional
Zobacz AdvancedMarkerElementOptions.zIndex.
element
To jest pole tylko do odczytu. Element DOM, który obsługuje widok.
content
Typ:  Node optional
Zobacz AdvancedMarkerElementOptions.content.
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.
addListener
addListener(eventName, handler)
Parametry: 
  • eventName:  string Zarejestrowane zdarzenie.
  • handler:  Function funkcja do obsługi zdarzeń.
Wartość zwracana:  MapsEventListener wynikowy detektor zdarzeń.
Dodaje podaną funkcję detektora do podanej nazwy zdarzenia w systemie zdarzeń Map.
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.
click
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu elementu AdvancedMarkerElement.

Niedostępne w przypadku addEventListener() (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 wywoływane, gdy użytkownik przestaje 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().
gmp-click
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu elementu AdvancedMarkerElement. Najlepiej używać z addEventListener() (zamiast addListener()).

Interfejs AdvancedMarkerElementOptions

Interfejs google.maps.marker.AdvancedMarkerElementOptions

Opcje tworzenia obiektu AdvancedMarkerElement.
anchorLeft optional
Typ:  string optional
Domyślnie: „-50%”
Wartość długości i procentu w CSS, która służy do przesunięcia punktu zakotwiczenia znacznika względem jego lewego górnego rogu. Jest to przydatne, gdy używasz elementu wizualnego, który ma punkt zakotwiczenia inny niż typowy dolny środkowy punkt domyślnego znacznika.
anchorTop optional
Typ:  string optional
Domyślnie: „-100%”
Wartość długości i procentu w CSS, która służy do przesunięcia punktu zakotwiczenia znacznika względem jego lewego górnego rogu. Jest to przydatne, gdy używasz elementu wizualnego, który ma punkt zakotwiczenia inny niż typowy dolny środkowy punkt domyślnego znacznika.
collisionBehavior optional
Typ:  CollisionBehavior optional
Wyliczenie określające, jak AdvancedMarkerElement powinien się zachowywać, gdy koliduje z innym AdvancedMarkerElement lub z etykietami mapy podstawowej na mapie wektorowej.

Uwaga: kolizja AdvancedMarkerElement z AdvancedMarkerElement działa zarówno na mapach rastrowych, jak i wektorowych, ale kolizja AdvancedMarkerElement z etykietą mapy podstawowej działa tylko na mapach wektorowych.
content optional
Typ:  Node optional
Domyślnie: PinElement
Element DOM, który stanowi podstawę wizualną elementu AdvancedMarkerElement.

Uwaga: AdvancedMarkerElement nie klonuje przekazanego elementu DOM. Gdy element DOM zostanie przekazany do elementu AdvancedMarkerElement, przekazanie tego samego elementu DOM do innego elementu AdvancedMarkerElement spowoduje przeniesienie elementu DOM i sprawi, że poprzedni element AdvancedMarkerElement będzie wyglądał na pusty.
gmpClickable optional
Typ:  boolean optional
Domyślnie: false
Jeśli true, AdvancedMarkerElement będzie można kliknąć i wywołać zdarzenie gmp-click. Będzie on też interaktywny na potrzeby ułatwień dostępu (np. umożliwiając nawigację za pomocą klawiatury i klawiszy strzałek).
gmpDraggable optional
Typ:  boolean optional
Domyślnie: false
Jeśli true, AdvancedMarkerElement można przeciągnąć.

Uwaga: AdvancedMarkerElement z wysokością nie można przeciągać.
map optional
Typ:  Map optional
Mapa, na której ma być wyświetlany element AdvancedMarkerElement. Mapa jest wymagana do wyświetlania AdvancedMarkerElement i można ją podać, ustawiając AdvancedMarkerElement.map, jeśli nie została podana podczas tworzenia.
position optional
Ustawia pozycję elementu AdvancedMarkerElement. Obiekt AdvancedMarkerElement można utworzyć bez pozycji, ale nie będzie on wyświetlany, dopóki nie zostanie podana jego pozycja – na przykład w wyniku działań lub wyborów użytkownika. Pozycję AdvancedMarkerElement można podać, ustawiając AdvancedMarkerElement.position, jeśli nie została podana podczas tworzenia.

Uwaga: AdvancedMarkerElement z wysokością jest obsługiwany tylko na mapach wektorowych.
title optional
Typ:  string optional
Tekst po najechaniu kursorem. Jeśli podasz 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 obiekty AdvancedMarkerElement są wyświetlane na mapie w kolejności ich wartości zIndex, przy czym obiekty o wyższych wartościach są wyświetlane przed obiektami AdvancedMarkerElement o niższych wartościach. Domyślnie AdvancedMarkerElement są wyświetlane zgodnie z ich pozycją w pionie na ekranie, przy czym AdvancedMarkerElement znajdujące się niżej są wyświetlane przed AdvancedMarkerElement znajdującymi się wyżej. Pamiętaj, że zIndex służy też do określania względnego priorytetu między znacznikami zaawansowanymi CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY. Wyższa wartość zIndex oznacza wyższy priorytet.

Klasa AdvancedMarkerClickEvent

google.maps.marker.AdvancedMarkerClickEvent zajęcia

To zdarzenie jest tworzone po kliknięciu znacznika zaawansowanego. Pozycję znacznika możesz sprawdzić za pomocą event.target.position.

Ta klasa rozszerza klasę Event.

Aby uzyskać dostęp, zadzwoń pod numer const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker").
Zobacz Biblioteki w Maps JavaScript API.

Klasa PinElement

google.maps.marker.PinElement zajęcia

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

Ta klasa rozszerza klasę HTMLElement.

Ta klasa implementuje interfejs PinElementOptions.

Aby uzyskać dostęp, zadzwoń pod numer const {PinElement} = await google.maps.importLibrary("marker").
Zobacz Biblioteki w Maps JavaScript API.
PinElement
PinElement([options])
Parametry: 
background
Typ:  string optional
Zobacz PinElementOptions.background.
borderColor
Typ:  string optional
Zobacz PinElementOptions.borderColor.
glyphColor
Typ:  string optional
Zobacz PinElementOptions.glyphColor.
glyphSrc
Typ:  URL|string optional
Zobacz PinElementOptions.glyphSrc.
glyphText
Typ:  string optional
Zobacz PinElementOptions.glyphText.
scale
Typ:  number optional
Zobacz PinElementOptions.scale.
element
To jest pole tylko do odczytu. Element DOM, który obsługuje widok.
glyph
Typ:  string|Element|URL optional
Zobacz PinElementOptions.glyph.
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.

PinElementOptions interface

Interfejs google.maps.marker.PinElementOptions

Opcje tworzenia elementu 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 pinezce.
glyphColor optional
Typ:  string optional
Kolor glifu. Obsługuje dowolną wartość koloru CSS.
glyphSrc optional
Typ:  URL|string optional
Źródło obrazu glifu, który ma być wyświetlany w pinezce.
glyphText optional
Typ:  string optional
Tekst wyświetlany w pinezce.
scale optional
Typ:  number optional
Domyślnie: 1
Skala pinezki.