Advanced Markers

Klasa AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement zajęcia

Pokazuje pozycję na mapie. Pamiętaj, że aby element AdvancedMarkerElement się wyświetlał, position musi być ustawiony.

Uwaga: użycie jako komponentu internetowego (np. niestandardowego elementu HTML <gmp-advanced-marker> jest dostępne tylko w kanale v=beta).

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

Ta klasa stanowi rozszerzenie zajęć HTMLElement.

Ta klasa implementuje AdvancedMarkerElementOptions.

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

AdvancedMarkerElement
AdvancedMarkerElement([options])
Parametry: 
Tworzy element AdvancedMarkerElement z określonymi opcjami. Jeśli określisz mapę, element AdvancedMarkerElement zostanie dodany do mapy podczas budowy.
collisionBehavior
Typ:  CollisionBehavior optional
content
Typ:  Node optional
element
To pole jest tylko do odczytu. Element DOM stanowiący kopię zapasową widoku.
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 reprezentujący typ nasłuchiwanego zdarzenia (wielkość liter ma znaczenie).
  • 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 zdarzenia capture i passive.
Zwracana wartość:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do miejsca docelowego. Zobacz addEventListener.
addListener
addListener(eventName, handler)
Parametry: 
  • eventNamestring Obserwowane zdarzenie.
  • handlerFunction funkcja do obsługi zdarzeń.
Zwracana wartość:  MapsEventListener Detektor wynikowych zdarzeń.
Dodaje daną funkcję odbiornika do podanej nazwy zdarzenia w systemie Eventing Map Google.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg tekstowy określający typ zdarzenia, z którego ma zostać usunięty odbiornik.
  • listenerEventListener|EventListenerObject odbiornik zdarzenia modułu obsługi zdarzeń do usunięcia z celu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Zwracana wartość:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej przez addEventListener. Zobacz removeEventListener.
click
function(event)
Argumenty: 
Zdarzenie to jest wywoływane po kliknięciu elementu AdvancedMarkerElement.

Funkcja niedostępna w usłudze addEventListener() (zamiast tego użyj gmp-click).
drag
function(event)
Argumenty: 
To zdarzenie jest wielokrotnie wywoływane, gdy użytkownik przeciąga AdvancedMarkerElement.

Niedostępne w systemie addEventListener().
dragend
function(event)
Argumenty: 
Zdarzenie to jest wywoływane, gdy użytkownik przestaje przeciągać: AdvancedMarkerElement.

Niedostępne w systemie addEventListener().
dragstart
function(event)
Argumenty: 
Zdarzenie to jest wywoływane, gdy użytkownik zacznie przeciągać element AdvancedMarkerElement.

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

Interfejs AdvancedMarkerElementOptions

google.maps.marker.AdvancedMarkerElementOptions interfejs

Opcje tworzenia obiektu AdvancedMarkerElement.

collisionBehavior optional
Typ:  CollisionBehavior optional
Wyliczenie określające sposób działania obiektu AdvancedMarkerElement w przypadku zderzenia 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, natomiast kolizja etykiet mapy bazowej z kolizją AdvancedMarkerElement działa tylko na mapach wektorowych.

content optional
Typ:  Node optional
Wartość domyślna: PinElement.element
Element DOM stanowiący kopię zapasową wyglądu obiektu AdvancedMarkerElement.

Uwaga: AdvancedMarkerElement nie klonuje przekazywanego elementu DOM. Po przekazaniu elementu DOM do obiektu AdvancedMarkerElement przekazanie tego samego elementu DOM do innego elementu AdvancedMarkerElement spowoduje przeniesienie tego elementu DOM i sprawienie, że poprzedni element AdvancedMarkerElement będzie pusty.

BetagmpClickable optional
Typ:  boolean optional
Wartość domyślna: false
Po wybraniu true element AdvancedMarkerElement będzie można kliknąć i wywołać zdarzenie gmp-click oraz będzie działał w celach związanych z ułatwieniami dostępu (np. umożliwił nawigację za pomocą klawiszy strzałek).
gmpDraggable optional
Typ:  boolean optional
Wartość domyślna: false
Jeśli ustawiona jest wartość true, można przeciągnąć element AdvancedMarkerElement.

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

map optional
Typ:  Map optional
Mapa, na której ma wyświetlać się AdvancedMarkerElement. Mapa jest wymagana do wyświetlania obiektu AdvancedMarkerElement. Można ją udostępnić, ustawiając wartość AdvancedMarkerElement.map, jeśli nie została ona udostępniona podczas budowy.
position optional
Określa pozycję urządzenia AdvancedMarkerElement. Element AdvancedMarkerElement może zostać utworzony bez pozycji, ale nie będzie wyświetlany, dopóki nie zostanie określona jego pozycja (np. w wyniku działań lub wyborów użytkownika). Pozycja obiektu AdvancedMarkerElement można określić, ustawiając wartość AdvancedMarkerElement.position, jeśli nie podano go w budowie.

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

title optional
Typ:  string optional
Tekst, który można najechać kursorem na tekst. Jeśli został podany, do elementu AdvancedMarkerElement zostanie dodany tekst ułatwień dostępu (np. przeznaczony do używania z czytnikami ekranu) z podaną wartością.
zIndex optional
Typ:  number optional
Wszystkie elementy AdvancedMarkerElement są wyświetlane na mapie w kolejności od zIndex. Większe wartości są wyświetlane przed AdvancedMarkerElement, a niższe. Domyślnie elementy typu AdvancedMarkerElement są wyświetlane zgodnie z umieszczonym na ekranie położeniem w pionie. Niższe AdvancedMarkerElement – przed AdvancedMarkerElement dalej od ekranu. Pamiętaj, że właściwość zIndex pomaga też określić względny priorytet 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 tworzy się przez kliknięcie znacznika zaawansowanego. Określ pozycję znacznika za pomocą event.target.position.

Ta klasa stanowi rozszerzenie zajęć Event.

Aby uzyskać dostęp, zadzwoń pod numer const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker"). Zobacz Biblioteki w interfejsie 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 w domyślnym elemencie AdvancedMarkerElement. Glif to opcjonalny element DOM wyświetlany w kształcie balonu. Element PinElement może mieć inny format obrazu w zależności od wartości atrybutu PinElement.scale.

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

Ta klasa stanowi rozszerzenie zajęć HTMLElement.

Ta klasa implementuje PinElementOptions.

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

PinElement
PinElement([options])
Parametry: 
background
Typ:  string optional
borderColor
Typ:  string optional
element
To pole jest tylko do odczytu. Element DOM stanowiący kopię zapasową 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 do użycia.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg tekstowy określający typ zdarzenia, z którego ma zostać usunięty odbiornik.
  • listenerEventListener|EventListenerObject odbiornik zdarzenia modułu obsługi zdarzeń do usunięcia z celu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Zwracana wartość:  void
Usuwa z elementu docelowego detektor zdarzeń zarejestrowany wcześniej przez addEventListener. Zobacz removeEventListener.

Interfejs PinElementOptions

google.maps.marker.PinElementOptions interfejs

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ęciu.
glyphColor optional
Typ:  string optional
Kolor glifu. Obsługuje dowolną wartość koloru CSS.
scale optional
Typ:  number optional
Wartość domyślna: 1
Skala pinezki.