Advanced Markers

Classe AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement classe

Mostra una posizione su una mappa. Tieni presente che è necessario impostare position per visualizzare AdvancedMarkerElement.

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.

Costruttore
AdvancedMarkerElement	AdvancedMarkerElement([options]) Parametri:  options:  AdvancedMarkerElementOptions optional Viene creato un elemento AdvancedMarkerElement con le opzioni specificate. Se viene specificata una mappa, AdvancedMarkerElement viene aggiunto alla mappa al momento della costruzione.

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 visualizzazione.
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	Avviso: disponibile soltanto nel canale v=beta. addEventListener(type, listener[, options]) Parametri:  type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare. 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à chiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Consulta la colonna addEventListener
addListener	addListener(eventName, handler) Parametri:  eventName:  string evento osservato. handler:  Function funzione per la gestione degli eventi. Valore restituito:  MapsEventListener Listener di eventi risultante. Aggiunge la funzione listener specificata al nome dell'evento specificato nel sistema Eventing di Maps.
removeEventListener	Avviso: disponibile soltanto nel canale v=beta. removeEventListener(type, listener[, options]) Parametri:  type:  string una stringa che specifica il tipo di evento per cui 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 c. 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	Avviso: disponibile soltanto nel canale v=beta. 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 creare un elemento AdvancedMarkerElement.

Proprietà
collisionBehavior optional	Tipo:  CollisionBehavior optional Un'enumerazione che specifica come deve comportarsi un AdvancedMarkerElement quando si scontra con un altro AdvancedMarkerElement o con le etichette della mappa base su una mappa vettoriale. Nota: la collisione da AdvancedMarkerElement a AdvancedMarkerElement funziona sia sulle mappe raster che vettoriali. Tuttavia, la collisione AdvancedMarkerElement con le etichette della mappa base funziona solo sulle mappe vettoriali.
content optional	Tipo:  Node optional Predefinita: PinElement.element L'elemento DOM a supporto della grafica 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, l'elemento DOM verrà spostato e l'elemento AdvancedMarkerElement precedente sembrerà vuoto.
gmpDraggable optional	Tipo:  boolean optional Predefinita: false Se true, è possibile trascinare AdvancedMarkerElement. Nota: AdvancedMarkerElement con altitudine non può essere trascinato.
map optional	Tipo:  Map optional Mappa sulla quale 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 dalle azioni o dalle scelte di un utente. La posizione di AdvancedMarkerElement può essere fornita impostando AdvancedMarkerElement.position se non viene fornita durante la costruzione. Nota: AdvancedMarkerElement con altitudine è supportato solo sulle mappe vettoriali.
title optional	Tipo:  string optional Testo del passaggio del mouse. Se fornito, verrà aggiunto a AdvancedMarkerElement un testo sull'accessibilità (ad esempio da utilizzare con screen reader) con il valore fornito.
zIndex optional	Tipo:  number optional Tutti gli elementi AdvancedMarkerElement vengono visualizzati sulla mappa in base al loro zIndex, con i valori più alti visualizzati davanti a AdvancedMarkerElement con valori più bassi. Per impostazione predefinita, i valori AdvancedMarkerElement vengono visualizzati in base alla loro posizione verticale sullo schermo, con i AdvancedMarkerElement più bassi davanti ai AdvancedMarkerElement più in alto sullo schermo. Tieni presente che zIndex viene utilizzato anche per determinare la priorità relativa tra gli indicatori avanzati di CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY. Un valore zIndex più elevato indica una priorità più elevata.

Classe AdvancedMarkerClickEvent

google.maps.marker.AdvancedMarkerClickEvent classe

Avviso: disponibile soltanto nel canale v=beta.

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.

Classe 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 fumetto di quello visualizzato nell'impostazione predefinita AdvancedMarkerElement. Il glifo è un elemento DOM facoltativo visualizzato sotto forma di fumetto. Un elemento PinElement potrebbe avere proporzioni diverse a seconda del relativo 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.

Costruttore
PinElement	PinElement([options]) Parametri:  options:  PinElementOptions optional

Proprietà
background	Tipo:  string optional Leggi i PinElementOptions.background.
borderColor	Tipo:  string optional Leggi i PinElementOptions.borderColor.
element	Tipo:  HTMLElement Questo campo è di sola lettura. L'elemento DOM a supporto della visualizzazione.
glyph	Tipo:  string|Element|URL optional Leggi i PinElementOptions.glyph.
glyphColor	Tipo:  string optional Leggi i PinElementOptions.glyphColor.
scale	Tipo:  number optional Leggi i PinElementOptions.scale.

Metodi
addEventListener	Avviso: disponibile soltanto nel canale v=beta. addEventListener(type, listener[, options]) Parametri:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional Valore restituito:  void Questa funzione non è ancora disponibile per l'uso.
removeEventListener	Avviso: disponibile soltanto nel canale v=beta. removeEventListener(type, listener[, options]) Parametri:  type:  string una stringa che specifica il tipo di evento per cui 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 c. Vedi removeEventListener

Interfaccia PinElementOptions

Interfaccia google.maps.marker.PinElementOptions

Opzioni per creare un PinElement.

Proprietà
background optional	Tipo:  string optional Il colore di sfondo della forma del segnaposto. Supporta qualsiasi valore colore CSS.
borderColor optional	Tipo:  string optional Il colore del bordo della forma del segnaposto. Supporta qualsiasi valore 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 colore CSS.
scale optional	Tipo:  number optional Predefinita: 1 La scala del segnaposto.