Advanced Markers

Classe AdvancedMarkerElement

Classe google.maps.marker.AdvancedMarkerElement

Mostra una posizione su una mappa. Tieni presente che l'attributo position deve essere impostato affinché l'attributo AdvancedMarkerElement venga visualizzato.

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

Questa classe estende HTMLElement.

Questa classe implementa AdvancedMarkerElementOptions.

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

Costruttore
AdvancedMarkerElement	AdvancedMarkerElement([options]) Parametri:  options:  AdvancedMarkerElementOptions optional Crea un AdvancedMarkerElement con le opzioni specificate. Se viene specificata una mappa, l'oggetto AdvancedMarkerElement viene aggiunto alla mappa al momento della creazione.

Proprietà
anchorLeft	Tipo:  string optional Valore predefinito: "-50%" Un valore di lunghezza-percentuale CSS utilizzato per compensare il punto di ancoraggio dell'indicatore dall'angolo in alto a sinistra dell'indicatore. Questa opzione è utile quando utilizzi un elemento visivo con un punto di ancoraggio diverso dal tipico punto centrale inferiore dell'indicatore predefinito. Attributo HTML: <gmp-advanced-marker anchor-left="string"></gmp-advanced-marker>
anchorTop	Tipo:  string optional Valore predefinito: "-100%" Un valore di lunghezza-percentuale CSS utilizzato per compensare il punto di ancoraggio dell'indicatore dall'angolo in alto a sinistra dell'indicatore. Questa opzione è utile quando utilizzi un elemento visivo con un punto di ancoraggio diverso dal tipico punto centrale inferiore dell'indicatore predefinito. Attributo HTML: <gmp-advanced-marker anchor-top="string"></gmp-advanced-marker>
collisionBehavior	Tipo:  CollisionBehavior optional Leggi i AdvancedMarkerElementOptions.collisionBehavior.
gmpClickable	Tipo:  boolean optional Leggi i AdvancedMarkerElementOptions.gmpClickable. Attributo HTML: <gmp-advanced-marker gmp-clickable></gmp-advanced-marker>
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.
element	Deprecato: utilizza direttamente AdvancedMarkerElement. Tipo:  HTMLElement Questo campo è di sola lettura. L'elemento DOM che supporta la visualizzazione.
content	Deprecato: utilizza .children. Tipo:  Node optional Leggi i AdvancedMarkerElementOptions.content.

Metodi
addEventListener	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 inviato alla destinazione. Consulta 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 evento specificato nel sistema di eventi di Maps.
removeEventListener	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 dal target dell'evento. options:  boolean|EventListenerOptions optional vedi le opzioni. Valore restituito:  void Rimuove dal target un listener di eventi precedentemente registrato con addEventListener. Consulta removeEventListener.

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

Interfaccia AdvancedMarkerElementOptions

Interfaccia google.maps.marker.AdvancedMarkerElementOptions

Opzioni per la creazione di un AdvancedMarkerElement.

Proprietà
anchorLeft optional	Tipo:  string optional Valore predefinito: "-50%" Un valore di lunghezza-percentuale CSS utilizzato per compensare il punto di ancoraggio dell'indicatore dall'angolo in alto a sinistra dell'indicatore. Questa opzione è utile quando utilizzi un elemento visivo con un punto di ancoraggio diverso dal tipico punto centrale inferiore dell'indicatore predefinito.
anchorTop optional	Tipo:  string optional Valore predefinito: "-100%" Un valore di lunghezza-percentuale CSS utilizzato per compensare il punto di ancoraggio dell'indicatore dall'angolo in alto a sinistra dell'indicatore. Questa opzione è utile quando utilizzi un elemento visivo con un punto di ancoraggio diverso dal tipico punto centrale inferiore dell'indicatore predefinito.
collisionBehavior optional	Tipo:  CollisionBehavior optional Un'enumerazione che specifica il comportamento di un AdvancedMarkerElement quando entra in conflitto con un altro AdvancedMarkerElement o con le etichette della mappa base su una mappa vettoriale. Nota: la collisione tra AdvancedMarkerElement e AdvancedMarkerElement funziona sia sulle mappe raster che su quelle vettoriali, mentre la collisione tra AdvancedMarkerElement e l'etichetta della mappa base funziona solo sulle mappe vettoriali.
content optional	Tipo:  Node optional Valore predefinito: PinElement L'elemento DOM che supporta l'aspetto visivo di un AdvancedMarkerElement. Nota: AdvancedMarkerElement non clona l'elemento DOM passato. Una volta che l'elemento DOM viene passato a un AdvancedMarkerElement, il passaggio dello stesso elemento DOM a un altro AdvancedMarkerElement sposterà l'elemento DOM e farà apparire vuoto l'AdvancedMarkerElement precedente.
gmpClickable optional	Tipo:  boolean optional Valore predefinito: false Se true, AdvancedMarkerElement sarà cliccabile e attiverà l'evento gmp-click, oltre a essere interattivo per l'accessibilità (ad es. consentendo la navigazione da tastiera tramite i tasti Freccia).
gmpDraggable optional	Tipo:  boolean optional Valore predefinito: false Se true, AdvancedMarkerElement può essere trascinato. Nota: AdvancedMarkerElement con 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 viene fornita durante la 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é non viene fornita la sua posizione, ad esempio tramite le azioni o le scelte di un utente. La posizione di un 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 di rollover. Se fornito, un testo di accessibilità (ad es. da utilizzare con gli screen reader) verrà aggiunto a AdvancedMarkerElement con il valore fornito.
zIndex optional	Tipo:  number optional Tutti gli elementi AdvancedMarkerElement vengono visualizzati sulla mappa in ordine di zIndex, con i valori più alti visualizzati davanti agli elementi 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. Tieni presente che zIndex viene utilizzato anche per determinare la priorità relativa tra i CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY indicatori avanzati. Un valore zIndex più alto indica una priorità più alta.

Classe AdvancedMarkerClickEvent

Classe google.maps.marker.AdvancedMarkerClickEvent

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 il numero const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker").
Consulta Librerie nell'API Maps JavaScript.

Classe PinElement

Classe google.maps.marker.PinElement

Un PinElement rappresenta un elemento DOM costituito da una forma e un glifo. La forma ha lo stesso stile di fumetto visualizzato nell'elemento AdvancedMarkerElement o Marker3DElement predefinito. Il glifo è un elemento DOM facoltativo visualizzato nella forma del fumetto. Un PinElement può avere proporzioni diverse a seconda del suo PinElement.scale.

Questa classe estende HTMLElement.

Questa classe implementa PinElementOptions.

Accedi chiamando il numero const {PinElement} = await google.maps.importLibrary("marker").
Consulta 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.
glyphColor	Tipo:  string optional Leggi i PinElementOptions.glyphColor.
glyphSrc	Tipo:  URL|string optional Leggi i PinElementOptions.glyphSrc.
glyphText	Tipo:  string optional Leggi i PinElementOptions.glyphText.
scale	Tipo:  number optional Leggi i PinElementOptions.scale.
element	Ritirato: utilizza direttamente PinElement. Tipo:  HTMLElement Questo campo è di sola lettura. L'elemento DOM che supporta la visualizzazione.
glyph	Deprecato: utilizza PinElementOptions.glyphText o PinElementOptions.glyphSrc. Tipo:  string|Element|URL optional Leggi i PinElementOptions.glyph.

Metodi
addEventListener	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 inviato alla destinazione. Consulta addEventListener.
removeEventListener	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 dal target dell'evento. options:  boolean|EventListenerOptions optional vedi le opzioni. Valore restituito:  void Rimuove dal target un listener di eventi precedentemente registrato con addEventListener. Consulta removeEventListener.

Interfaccia PinElementOptions

Interfaccia google.maps.marker.PinElementOptions

Opzioni per la creazione di un PinElement.

Proprietà
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	Deprecato: utilizza PinElementOptions.glyphText o PinElementOptions.glyphSrc. 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.
glyphSrc optional	Tipo:  URL|string optional L'origine dell'immagine del glifo da visualizzare nel segnaposto.
glyphText optional	Tipo:  string optional Il testo visualizzato nel segnaposto.
scale optional	Tipo:  number optional Valore predefinito: 1 La scala del segnaposto.