Advanced Markers

Klasa AdvancedMarkerElement

Klasa google.maps.marker.AdvancedMarkerElement

Pokazuje pozycję na mapie. Pamiętaj, że aby właściwość AdvancedMarkerElement była widoczna, należy ustawić position.

Uwaga: użycie jako komponentu internetowego (np. przy użyciu 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>

Te zajęcia obejmują HTMLElement.

Te zajęcia implementują AdvancedMarkerElementOptions.

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

AdvancedMarkerElement
AdvancedMarkerElement([options])
Parametry: 
Tworzy element AdvancedMarkerElement z określonymi opcjami. Jeśli określisz mapę, obiekt AdvancedMarkerElement zostanie dodany do mapy podczas tworzenia.
collisionBehavior
Typ:  CollisionBehavior optional
content
Typ:  Node optional
element
To pole jest tylko do odczytu. Element DOM tworzący widok.
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 wielkość liter w nagłówku oznacza typ zdarzenia, które ma być nasłuchiwane.
  • listenerEventListener|EventListenerObject obiekt, który otrzymuje powiadomienia. 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 celu. Zobacz addEventListener
addListener
addListener(eventName, handler)
Parametry: 
  • eventNamestring Odnotowane zdarzenie.
  • handlerFunction funkcja obsługi zdarzeń.
Zwracana wartość:  MapsEventListener detektor zdarzeń.
Dodaje podaną funkcję detektora do nazwy zdarzenia w systemie zdarzeń map.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametry: 
  • typestring to ciąg znaków określający typ zdarzenia, dla którego chcesz usunąć detektor.
  • listenerEventListener|EventListenerObject odbiornik zdarzenia modułu obsługi zdarzeń, które chcesz usunąć z celu zdarzenia
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Wartość zwrotu:  void
Usuwa odbiornik zarejestrowany wcześniej w usłudze addEventListener z poziomu elementu docelowego. Zobacz removeEventListener
click
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu elementu AdvancedMarkerElement.

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

Funkcja jest niedostępna w aplikacji addEventListener().
dragend
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik przestaje przeciągać element AdvancedMarkerElement.

Funkcja jest niedostępna w aplikacji addEventListener().
dragstart
function(event)
Argumenty: 
To zdarzenie jest wywoływane, gdy użytkownik zacznie przeciągać element AdvancedMarkerElement.

Funkcja jest niedostępna w aplikacji addEventListener().
Betagmp-click
function(event)
Argumenty: 
To zdarzenie jest wywoływane po kliknięciu elementu AdvancedMarkerElement. Najlepiej sprawdza się przy użyciu atrybutu addEventListener() (zamiast addListener()).

Interfejs AdvancedMarkerElementOptions

google.maps.marker.AdvancedMarkerElementOptions interfejs

Opcje tworzenia komponentu AdvancedMarkerElement.

collisionBehavior optional
Typ:  CollisionBehavior optional
Liczba określająca, w jaki sposób AdvancedMarkerElement powinien zachowywać się w przypadku zderzenia z innym elementem AdvancedMarkerElement lub z mapą bazową na mapie wektorowej.

Uwaga: kolizja AdvancedMarkerElement od AdvancedMarkerElement działa zarówno w przypadku map rastrowych, jak i wektorowych, ale ustawienie AdvancedMarkerElement w przypadku kolizji etykiet mapy podstawowej działa tylko na mapach wektorowych.

content optional
Typ:  Node optional
Element DOM tworzący wygląd elementu AdvancedMarkerElement.

Uwaga: AdvancedMarkerElement nie kopiuje przekazywanego elementu DOM. Po przesłaniu elementu DOM do elementu AdvancedMarkerElement przesłanie tego samego elementu DOM do innego obiektu AdvancedMarkerElement spowoduje przeniesienie elementu DOM, przez co poprzedni element AdvancedMarkerElement będzie wyglądał na pusty.

gmpDraggable optional
Typ:  boolean optional
Domyślne: false
Jeśli zasada true, AdvancedMarkerElement można przeciągnąć.

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

map optional
Typ:  Map optional
Mapa, na której wyświetla się AdvancedMarkerElement. Mapa jest niezbędna do wyświetlenia obiektu AdvancedMarkerElement. Jeśli nie została podana na etapie tworzenia, może zostać ustawiona przez ustawienie AdvancedMarkerElement.map.
position optional
Ustawia pozycję obiektu AdvancedMarkerElement. AdvancedMarkerElement można utworzyć bez pozycji, ale nie będzie on wyświetlany, dopóki użytkownik nie poda swojej pozycji, np. na podstawie działań lub wyborów użytkownika. Pozycja AdvancedMarkerElement można podać, ustawiając AdvancedMarkerElement.position, jeśli nie podano jej w budowie.

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

title optional
Typ:  string optional
Tekst po najechaniu kursorem. Jeśli podasz tekst ułatwień dostępu (np. na potrzeby czytników ekranu), do AdvancedMarkerElement zostanie wpisana podana wartość.
zIndex optional
Typ:  number optional
Wszystkie AdvancedMarkerElement są wyświetlane na mapie w kolejności ich kolejności nakładania elementów, przy czym wyższe wartości wyświetlają się przed elementem AdvancedMarkerElement o niższych wartościach. Domyślnie elementy (AdvancedMarkerElement) są wyświetlane zgodnie z ich pionową orientacją na ekranie, a niższe AdvancedMarkerElement mają przed sobą dalszy ciąg.AdvancedMarkerElement Pamiętaj, że parametr zIndex służy też do określania względnego priorytetu między zaawansowanymi znacznikami CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY. Wyższa wartość zIndex wskazuje wyższy priorytet.

Klasa AdvancedMarkerClickEvent

Klasa google.maps.marker.AdvancedMarkerClickEvent

To zdarzenie jest tworzone po kliknięciu zaawansowanego znacznika. Określ pozycję znacznika za pomocą event.target.position.

Te zajęcia obejmują Event.

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

Klasa PinElement

Klasa google.maps.marker.PinElement

PinElement reprezentuje element DOM składający się z kształtu i glifu. Kształt ma ten sam styl balonu co w domyślnym elemencie AdvancedMarkerElement. Glif to opcjonalny element DOM wyświetlany w kształcie dymków. PinElement może mieć inny współczynnik proporcji w zależności od elementu PinElement.scale.

Uwaga: użycie jako komponentu internetowego (np. przez wykorzystanie klasy podrzędnej HTMLElement lub przez HTML) nie jest jeszcze obsługiwane.

Te zajęcia obejmują HTMLElement.

Te zajęcia implementują PinElementOptions.

Zadzwoń pod numer const {PinElement} = await google.maps.importLibrary("marker"), aby uzyskać dostęp. 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 tworzący widok.
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 to ciąg znaków określający typ zdarzenia, dla którego chcesz usunąć detektor.
  • listenerEventListener|EventListenerObject odbiornik zdarzenia modułu obsługi zdarzeń, które chcesz usunąć z celu zdarzenia
  • optionsboolean|EventListenerOptions optional Zobacz opcje
Wartość zwrotu:  void
Usuwa odbiornik zarejestrowany wcześniej w usłudze addEventListener z poziomu elementu docelowego. Zobacz removeEventListener

Interfejs PinElementOptions

google.maps.marker.PinElementOptions interfejs

Opcje tworzenia instancji 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 na pinezki.
glyphColor optional
Typ:  string optional
Kolor glifu. Obsługuje dowolną wartość koloru CSS.
scale optional
Typ:  number optional
Domyślne: 1
Skala pinezki.