Advanced Markers

Classe AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement classe

Mostra una posizione su una mappa. Tieni presente che è necessario impostare position affinché AdvancedMarkerElement venga visualizzato.

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

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

Questa classe estende HTMLElement.

Questa classe implementa AdvancedMarkerElementOptions.

Accedi chiamando const {AdvancedMarkerElement} = await google.maps.importLibrary("marker"). Consulta la sezione Librerie nell'API Maps JavaScript.

Proprietà
collisionBehavior	Tipo:  CollisionBehavior optional Leggi i AdvancedMarkerElementOptions.collisionBehavior.
content	Tipo:  Node optional Leggi i AdvancedMarkerElementOptions.content.
element	Tipo:  HTMLElement Questo campo è di sola lettura. L'elemento DOM a supporto della vista.
gmpClickable	Tipo:  boolean optional Leggi i AdvancedMarkerElementOptions.gmpClickable.
gmpDraggable	Tipo:  boolean optional Leggi i AdvancedMarkerElementOptions.gmpDraggable.
map	Tipo:  Map optional Leggi i AdvancedMarkerElementOptions.map.
position	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Leggi i AdvancedMarkerElementOptions.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 Leggi i AdvancedMarkerElementOptions.title. Attributo HTML: <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex	Tipo:  number optional Leggi i AdvancedMarkerElementOptions.zIndex.

Metodi
addEventListener	addEventListener(type, listener[, options]) Parametri:  type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da rimanere in ascolto. listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent options:  boolean|AddEventListenerOptions optional Vedi le opzioni. Gli eventi personalizzati supportano solo capture e passive. Valore restituito:  void Configura una funzione che verrà richiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Consulta la funzione addEventListener
addListener	addListener(eventName, handler) Parametri:  eventName:  string evento osservato. handler:  Function funzione per gestire gli eventi. Valore restituito:  MapsEventListener listener di eventi risultante. Aggiunge la funzione listener specificata al nome dell'evento specificato nel sistema Eventing di Maps.
removeEventListener	removeEventListener(type, listener[, options]) Parametri:  type:  string una stringa che specifica il tipo di evento per il quale rimuovere un listener di eventi. listener:  EventListener|EventListenerObject il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento. options:  boolean|EventListenerOptions optional Vedi le opzioni Valore restituito:  void Rimuove dalla destinazione un listener di eventi precedentemente registrato con hreflang. Vedi removeEventListener

Eventi
click	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando si fa clic sull'elemento AdvancedMarkerElement. Non disponibile con addEventListener() (utilizza invece gmp-click).
drag	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato ripetutamente mentre l'utente trascina AdvancedMarkerElement. Non disponibile con addEventListener().
dragend	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'utente smette di trascinare AdvancedMarkerElement. Non disponibile con addEventListener().
dragstart	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'utente inizia a trascinare AdvancedMarkerElement. Non disponibile con addEventListener().
gmp-click	function(event) Argomenti:  event:  AdvancedMarkerClickEvent Questo evento viene attivato quando si fa clic sull'elemento AdvancedMarkerElement. Ideale per l'uso con addEventListener() (anziché addListener()).

Interfaccia AdvancedMarkerElementOptions

Interfaccia google.maps.marker.AdvancedMarkerElementOptions

Opzioni per la creazione di un AdvancedMarkerElement.

Proprietà
collisionBehavior optional	Tipo:  CollisionBehavior optional Un'enumerazione che specifica il comportamento di AdvancedMarkerElement in caso di collisione con un altro AdvancedMarkerElement o con le etichette della mappa base su una mappa vettoriale. Nota: la collisione AdvancedMarkerElement-AdvancedMarkerElement funziona sia sulle mappe raster che su quella vettoriale. Tuttavia, la collisione AdvancedMarkerElement con l'etichetta della mappa base funziona solo sulle mappe vettoriali.
content optional	Tipo:  Node optional Predefinito: PinElement.element L'elemento DOM a supporto dell'immagine di un AdvancedMarkerElement. Nota: AdvancedMarkerElement non clona l'elemento DOM passato. Dopo che l'elemento DOM viene passato a un AdvancedMarkerElement, se passi lo stesso elemento DOM a un altro AdvancedMarkerElement si sposterà l'elemento DOM e l'elemento AdvancedMarkerElement precedente sembrerà vuoto.
gmpClickable optional	Tipo:  boolean optional Predefinito: false Se true, l'elemento AdvancedMarkerElement sarà cliccabile e attiverà l'evento gmp-click, e sarà interattivo per motivi di accessibilità (ad esempio consentendo la navigazione da tastiera tramite i tasti freccia).
gmpDraggable optional	Tipo:  boolean optional Predefinito: false Se true, è possibile trascinare AdvancedMarkerElement. Nota: AdvancedMarkerElement con altitudine non può essere trascinato.
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 viene fornita in fase di costruzione.
position optional	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Imposta la posizione di AdvancedMarkerElement. Un AdvancedMarkerElement può essere creato senza una posizione, ma non verrà visualizzato finché la sua posizione non sarà fornita, ad esempio tramite le azioni o le scelte di un utente. La posizione di AdvancedMarkerElement può essere fornita impostando AdvancedMarkerElement.position se non viene fornita durante la costruzione. Nota: AdvancedMarkerElement con l'altitudine è supportato solo sulle mappe vettoriali.
title optional	Tipo:  string optional Testo riporto. Se fornito, un testo sull'accessibilità (ad esempio per l'uso con screen reader) verrà aggiunto a AdvancedMarkerElement con il valore specificato.
zIndex optional	Tipo:  number optional Tutti gli elementi AdvancedMarkerElement vengono visualizzati sulla mappa in ordine di zIndex, con i valori più alti visualizzati davanti a AdvancedMarkerElement con valori più bassi. Per impostazione predefinita, gli elementi AdvancedMarkerElement vengono visualizzati in base alla loro posizione verticale sullo schermo, mentre i AdvancedMarkerElement più bassi vengono visualizzati davanti ai AdvancedMarkerElement più in alto sullo schermo. Tieni presente che zIndex viene utilizzato anche per determinare la priorità relativa tra gli indicatori avanzati CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY. Un valore zIndex più elevato 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 dell'indicatore con event.target.position.

Questa classe estende Event.

Accedi chiamando const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker"). Consulta la sezione Librerie nell'API Maps JavaScript.

PinElement

google.maps.marker.PinElement classe

Un PinElement rappresenta un elemento DOM costituito da una forma e da un glifo. La forma ha lo stesso stile di fumetto di AdvancedMarkerElement. Il glifo è un elemento DOM facoltativo visualizzato sotto forma di fumetto. Un PinElement potrebbe avere proporzioni diverse a seconda del suo PinElement.scale.

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

Questa classe estende HTMLElement.

Questa classe implementa PinElementOptions.

Accedi chiamando const {PinElement} = await google.maps.importLibrary("marker"). Consulta la sezione Librerie nell'API Maps JavaScript.

Metodi
addEventListener	addEventListener(type, listener[, options]) Parametri:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional Valore restituito:  void Questa funzione non è ancora disponibile per l'utilizzo.
removeEventListener	removeEventListener(type, listener[, options]) Parametri:  type:  string una stringa che specifica il tipo di evento per il quale rimuovere un listener di eventi. listener:  EventListener|EventListenerObject il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento. options:  boolean|EventListenerOptions optional Vedi le opzioni Valore restituito:  void Rimuove dalla destinazione un listener di eventi precedentemente registrato con hreflang. Vedi removeEventListener

Interfaccia PinElementOptions

Interfaccia google.maps.marker.PinElementOptions

Opzioni per creare un PinElement.