Advanced Markers

Classe AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement classe

Mostra una posizione su una mappa. Tieni presente che position deve essere impostato per la visualizzazione di AdvancedMarkerElement.

Nota:l'utilizzo come componente web (ad es. l'utilizzo dell'elemento HTML personalizzato <gmp-advanced-marker>) è disponibile solo nel canale v=beta.

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

Questo corso si estende HTMLElement.

Questa classe implementa AdvancedMarkerElementOptions.

Accesso chiamando il numero const {AdvancedMarkerElement} = await google.maps.importLibrary("marker").
Consulta Librerie nell'API Maps JavaScript.

AdvancedMarkerElement
AdvancedMarkerElement([options])
Parametri: 
Crea un AdvancedMarkerElement con le opzioni specificate. Se viene specificata una mappa, AdvancedMarkerElement viene aggiunto alla mappa durante la costruzione.
collisionBehavior
Tipo:  CollisionBehavior optional
content
Tipo:  Node optional
element
Tipo:  HTMLElement
Questo campo è di sola lettura. L'elemento DOM che supporta la visualizzazione.
BetagmpClickable
Tipo:  boolean optional
gmpDraggable
Tipo:  boolean optional
map
Tipo:  Map optional
position
Attributo HTML:
  • <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker>
  • <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title
Tipo:  string
Attributo HTML:
  • <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex
Tipo:  number optional
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa sensibile alle maiuscole e minuscole che rappresenta il tipo di evento da ascoltare.
  • listenerEventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • optionsboolean|AddEventListenerOptions optional vedi le opzioni. Gli eventi personalizzati supportano solo capture e passive.
Valore restituito:  void
Configura una funzione che verrà chiamata ogni volta che l'evento specificato viene inviato alla destinazione. Vedi addEventListener
addListener
addListener(eventName, handler)
Parametri: 
  • eventNamestring evento osservato.
  • handlerFunction Funzione per gestire gli eventi.
Valore restituito:MapsEventListener listener di eventi risultante.
Aggiunge la funzione listener specificata al nome dell'evento specificato nel sistema di gestione degli eventi di Maps.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa che specifica il tipo di evento per cui rimuovere un listener di eventi.
  • listenerEventListener|EventListenerObject Il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento.
  • optionsboolean|EventListenerOptions optional vedi le opzioni.
Valore restituito:  void
Rimuove dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.
click
function(event)
Argomenti: 
Questo evento viene attivato quando viene fatto clic sull'elemento AdvancedMarkerElement.

Non disponibile con addEventListener() (utilizza gmp-click).
drag
function(event)
Argomenti: 
Questo evento viene attivato ripetutamente mentre l'utente trascina AdvancedMarkerElement.

Non disponibile con addEventListener().
dragend
function(event)
Argomenti: 
Questo evento viene attivato quando l'utente smette di trascinare AdvancedMarkerElement.

Non disponibile con addEventListener().
dragstart
function(event)
Argomenti: 
Questo evento viene attivato quando l'utente inizia a trascinare AdvancedMarkerElement.

Non disponibile con addEventListener().
Betagmp-click
function(event)
Argomenti: 
Questo evento viene attivato quando viene fatto clic sull'elemento AdvancedMarkerElement. Da utilizzare preferibilmente con addEventListener() (anziché addListener()).

Interfaccia AdvancedMarkerElementOptions

google.maps.marker.AdvancedMarkerElementOptions interfaccia

Opzioni per la creazione di un AdvancedMarkerElement.

collisionBehavior optional
Tipo:  CollisionBehavior optional
Un'enumerazione che specifica il comportamento di un AdvancedMarkerElement quando entra in collisione con un altro AdvancedMarkerElement o con le etichette della basemap su una mappa vettoriale.

Nota: la collisione da AdvancedMarkerElement a AdvancedMarkerElement funziona sia su mappe raster che vettoriali, mentre la collisione da AdvancedMarkerElement all'etichetta della mappa di base funziona solo su mappe vettoriali.

content optional
Tipo:  Node optional
Predefinito: PinElement.element
L'elemento DOM che supporta l'aspetto visivo di un AdvancedMarkerElement.

Nota: AdvancedMarkerElement non clona l'elemento DOM passato. Una volta passato l'elemento DOM a un AdvancedMarkerElement, il passaggio dello stesso elemento DOM a un altro AdvancedMarkerElement sposterà l'elemento DOM e farà sembrare vuoto il AdvancedMarkerElement precedente.

BetagmpClickable optional
Tipo:  boolean optional
Predefinito: false
Se true, il AdvancedMarkerElement sarà cliccabile e attiverà l'evento gmp-click e sarà interattivo per scopi di accessibilità (ad es. consentendo la navigazione da tastiera tramite i tasti freccia).
gmpDraggable optional
Tipo:  boolean optional
Predefinito: false
Se true, AdvancedMarkerElement può essere trascinato.

Nota: AdvancedMarkerElement con l'altitudine non è trascinabile.

map optional
Tipo:  Map optional
Mappa su cui visualizzare AdvancedMarkerElement. La mappa è necessaria per visualizzare AdvancedMarkerElement e può essere fornita impostando AdvancedMarkerElement.map se non è stata fornita durante la creazione.
position optional
Imposta la posizione di AdvancedMarkerElement. Un AdvancedMarkerElement può essere creato senza una posizione, ma non verrà visualizzato finché non viene fornita la posizione, ad esempio dalle azioni o dalle scelte di un utente. La posizione di un AdvancedMarkerElement può essere fornita impostando AdvancedMarkerElement.position se non è stata fornita durante la costruzione.

Nota: AdvancedMarkerElement con altitudine è supportato solo sulle mappe vettoriali.

title optional
Tipo:  string optional
Testo rollover. Se fornito, al tag AdvancedMarkerElement verrà aggiunto un testo di accessibilità (ad es. per l'utilizzo con screen reader) con il valore fornito.
zIndex optional
Tipo:  number optional
Tutti i AdvancedMarkerElement vengono visualizzati sulla mappa in base al relativo zIndex, con i valori più alti visualizzati davanti ai AdvancedMarkerElement con valori più bassi. Per impostazione predefinita, i AdvancedMarkerElement vengono visualizzati in base alla loro posizione verticale sullo schermo, con i AdvancedMarkerElement più in basso che appaiono davanti ai AdvancedMarkerElement più in alto sullo schermo. Tieni presente che zIndex viene utilizzato anche per determinare la priorità relativa tra i CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY indicatori avanzati. Un valore di zIndex più alto indica una priorità più elevata.

Classe AdvancedMarkerClickEvent

google.maps.marker.AdvancedMarkerClickEvent classe

Questo evento viene creato facendo clic su un indicatore avanzato. Accedi alla posizione del marcatore con event.target.position.

Questo corso si estende Event.

Accesso chiamando il numero const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker").
Consulta Librerie nell'API Maps JavaScript.

PinElement class

google.maps.marker.PinElement classe

Un PinElement rappresenta un elemento DOM costituito da una forma e un glifo. La forma ha lo stesso stile di fumetto visto nel AdvancedMarkerElement predefinito. Il glifo è un elemento DOM facoltativo visualizzato nella forma a palloncino. Un PinElement potrebbe avere un formato diverso a seconda del PinElement.scale.

Nota:l'utilizzo come componente web (ad esempio come sottoclasse HTMLElement o tramite HTML) non è ancora supportato.

Questo corso si estende HTMLElement.

Questa classe implementa PinElementOptions.

Accesso chiamando il numero const {PinElement} = await google.maps.importLibrary("marker").
Consulta Librerie nell'API Maps JavaScript.

PinElement
PinElement([options])
Parametri: 
background
Tipo:  string optional
borderColor
Tipo:  string optional
element
Tipo:  HTMLElement
Questo campo è di sola lettura. L'elemento DOM che supporta la visualizzazione.
glyph
Tipo:  string|Element|URL optional
glyphColor
Tipo:  string optional
scale
Tipo:  number optional
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
Valore restituito:  void
Questa funzione non è ancora disponibile per l'utilizzo.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa che specifica il tipo di evento per cui rimuovere un listener di eventi.
  • listenerEventListener|EventListenerObject Il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento.
  • optionsboolean|EventListenerOptions optional vedi le opzioni.
Valore restituito:  void
Rimuove dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.

Interfaccia PinElementOptions

google.maps.marker.PinElementOptions interfaccia

Opzioni per la creazione di un PinElement.

background optional
Tipo:  string optional
Il colore di sfondo della forma del segnaposto. Supporta qualsiasi valore di colore CSS.
borderColor optional
Tipo:  string optional
Il colore del bordo della forma del segnaposto. Supporta qualsiasi valore di colore CSS.
glyph optional
Tipo:  string|Element|URL optional
L'elemento DOM visualizzato nel segnaposto.
glyphColor optional
Tipo:  string optional
Il colore del glifo. Supporta qualsiasi valore di colore CSS.
scale optional
Tipo:  number optional
Predefinito: 1
La scala del segnaposto.