Advanced Markers

Klasa AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement zajęcia

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

Uwaga: użycie jako komponentu internetowego (np. za pomocą niestandardowego elementu HTML <gmp-advanced-marker> jest możliwe tylko w kanale v=beta).

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

Te zajęcia są rozszerzone na 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 do niej dodany podczas budowy.
collisionBehavior
Typ:  CollisionBehavior optional
content
Typ:  Node optional
element
To pole jest tylko do odczytu. Element DOM stanowiący kopię zapasową widoku.
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 (z rozróżnianiem wielkości liter).
  • 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.
Wartość zwrotu:  void
Konfiguruje funkcję, która będzie wywoływana za każdym razem, gdy określone zdarzenie zostanie dostarczone do środowiska docelowego. Zobacz addEventListener.
addListener
addListener(eventName, handler)
Parametry: 
  • eventNamestring Zaobserwowane zdarzenie.
  • handlerFunction funkcja do obsługi zdarzeń.
Zwracana wartość:  MapsEventListener detektor zdarzeń wynikowych.
Dodaje podaną funkcję detektora do podanej nazwy zdarzenia w systemie obsługi zdarzeń Map Google.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring ciąg tekstowy określający typ zdarzenia, z którego ma zostać usunięty detektor zdarzeń.
  • listenerEventListener|EventListenerObject detektor modułu obsługi zdarzeń, który ma zostać usunięty z celu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Wartość zwrotu:  void
Usuwa z celu detektor zdarzeń zarejestrowany wcześniej w addEventListener. Zobacz removeEventListener.
click
function(event)
Argumenty: 
Zdarzenie to jest wywoływane po kliknięciu elementu AdvancedMarkerElement.

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

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

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

Niedostępne w sieci addEventListener().
Betagmp-click
function(event)
Argumenty: 
Zdarzenie to jest wywoływane po kliknięciu elementu AdvancedMarkerElement. Najlepiej używany z elementem 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 zachowania elementu AdvancedMarkerElement w przypadku zderzenia z innym elementem AdvancedMarkerElement lub z etykietami mapy bazowej na mapie wektorowej.

Uwaga: kolizja między AdvancedMarkerElement a AdvancedMarkerElement działa zarówno na mapach rastrowych, jak i wektorowych, natomiast kolizja etykiet AdvancedMarkerElement w odniesieniu do mapy podstawowej działa tylko na mapach wektorowych.

content optional
Typ:  Node optional
Wartość domyślna: PinElement.element
Element DOM stanowiący podstawę wizualizacji AdvancedMarkerElement.

Uwaga: AdvancedMarkerElement nie klonuje przekazanego elementu DOM. Po przekazaniu elementu DOM do elementu AdvancedMarkerElement przekazanie tego samego elementu DOM do innego elementu AdvancedMarkerElement spowoduje przeniesienie tego elementu i sprawienie, że poprzedni element AdvancedMarkerElement będzie wyglądać na pusty.

gmpDraggable optional
Typ:  boolean optional
Wartość domyślna: false
Jeśli ustawiona jest wartość true, można przeciągnąć obiekt AdvancedMarkerElement.

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

map optional
Typ:  Map optional
Mapa, na której ma wyświetlać się AdvancedMarkerElement. Mapa jest niezbędna do wyświetlania AdvancedMarkerElement. Można ją dodać, 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 jej w konstrukcji.

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

title optional
Typ:  string optional
Tekst wyświetlany po najechaniu kursorem myszy. Jeśli zostanie podany, do AdvancedMarkerElement zostanie dodany tekst ułatwień dostępu (np. do używania z czytnikami ekranu) z podaną wartością.
zIndex optional
Typ:  number optional
Wszystkie obiekty AdvancedMarkerElement są wyświetlane na mapie w kolejności według ich zIndex. Niższe wartości są wyświetlane przed AdvancedMarkerElement, a niższe. Domyślnie elementy AdvancedMarkerElement są wyświetlane zgodnie z pozycją pionową na ekranie. Niższe AdvancedMarkerElement znajdują się przed innymi elementami (AdvancedMarkerElement). Pamiętaj, że właściwość 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 tworzy się przez kliknięcie znacznika zaawansowanego. Dostęp do pozycji znacznika możesz uzyskać za pomocą aplikacji event.target.position.

Te zajęcia są rozszerzone na 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 glifa. Kształt ma taki sam styl dymka jak w domyślnym elemencie AdvancedMarkerElement. Glif to opcjonalny element DOM wyświetlany w kształcie dymka. PinElement może mieć inny format obrazu w zależności od tego, czy jego parametr PinElement.scale ma swój format.

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

Te zajęcia są rozszerzone na 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: 
Wartość zwrotu:  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 detektor zdarzeń.
  • listenerEventListener|EventListenerObject detektor modułu obsługi zdarzeń, który ma zostać usunięty z celu zdarzenia.
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Wartość zwrotu:  void
Usuwa z celu detektor zdarzeń zarejestrowany wcześniej w 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.