Marker (legacy)

Classe Marker

google.maps.Marker class
extends MVCObject
library "marker"

Ritirato: a partire dal 21 febbraio 2024, google.maps.Marker verrà ritirato. Utilizza AdvancedMarkerElement. Al momento, non è prevista la dismissione di google.maps.Marker, ma è consigliabile utilizzare AdvancedMarkerElement anziché google.maps.Marker. Sebbene google.maps.Marker continuerà a ricevere correzioni di bug per eventuali regressioni importanti, i bug esistenti in google.maps.Marker non verranno risolti. Verrà dato un preavviso di almeno 12 mesi prima dell'interruzione dell'assistenza. Per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/deprecations e la guida alla migrazione all'indirizzo https://developers.google.com/maps/documentation/javascript/advanced-markers/migration.

const {Marker} = await google.maps.importLibrary("marker");

Costruttore
Marker	Marker([opts]) Parametri: opts: MarkerOptions optional Crea un indicatore con le opzioni specificate. Se viene specificata una mappa, l'indicatore viene aggiunto alla mappa al momento della creazione. Tieni presente che la posizione deve essere impostata affinché l'indicatore venga visualizzato.

Costanti
MAX_ZINDEX	L'indice z predefinito massimo che l'API assegnerà a un indicatore. Puoi impostare un indice z più alto per portare un indicatore in primo piano.

Metodi
getAnimation	getAnimation() Parametri: nessuno Valore restituito: Animation|null|undefined Recupera l'animazione attualmente in esecuzione.
getClickable	getClickable() Parametri: nessuno Valore restituito: boolean True se l'indicatore è selezionabile. Visualizzare lo stato di cliccabilità di Marker.
getCursor	getCursor() Parametri: nessuno Valore restituito: string|null|undefined Recupera il tipo di cursore del mouse mostrato al passaggio del mouse.
getDraggable	getDraggable() Parametri: nessuno Valore restituito: boolean True se l'indicatore è trascinabile. Recupera lo stato di trascinabilità di Marker.
getIcon	getIcon() Parametri: nessuno Valore restituito: string|Icon|Symbol|null|undefined Recupera l'icona della risorsa Marker. Leggi i MarkerOptions.icon.
getLabel	getLabel() Parametri: nessuno Valore restituito: MarkerLabel|string|null|undefined Recupera l'etichetta di Marker. Leggi i MarkerOptions.label.
getMap	getMap() Parametri: nessuno Valore restituito: Map|StreetViewPanorama|null Recupera la mappa o il panorama su cui viene eseguito il rendering di Marker.
getOpacity	getOpacity() Parametri: nessuno Valore restituito: number|null|undefined un numero compreso tra 0,0 e 1,0. Recupera l'opacità di Marker.
getPosition	getPosition() Parametri: nessuno Valore restituito: LatLng|null|undefined Recupera la posizione della risorsa Marker.
getShape	getShape() Parametri: nessuno Valore restituito: MarkerShape|null|undefined Recupera la forma del Marker utilizzato per l'interazione. Leggi i MarkerOptions.shape e la MarkerShape.
getTitle	getTitle() Parametri: nessuno Valore restituito: string|null|undefined Ottieni il titolo del tooltip Marker. Leggi i MarkerOptions.title.
getVisible	getVisible() Parametri: nessuno Valore restituito: boolean True se l'indicatore è visibile. Ottieni la visibilità della risorsa Marker.
getZIndex	getZIndex() Parametri: nessuno Valore restituito: number|null|undefined zIndex dell'indicatore. Recupera lo zIndex di Marker. Leggi i MarkerOptions.zIndex.
setAnimation	setAnimation([animation]) Parametri: animation: Animation optional l'animazione da riprodurre. Valore restituito: nessuno Avvia un'animazione. Qualsiasi animazione in corso verrà annullata. Le animazioni attualmente supportate sono: Animation.BOUNCE, Animation.DROP. Se passi null, l'animazione si interromperà.
setClickable	setClickable(flag) Parametri: flag: boolean se true, l'indicatore è selezionabile. Valore restituito: nessuno Imposta se l'elemento Marker è cliccabile.
setCursor	setCursor([cursor]) Parametri: cursor: tipo di cursore del mouse string optional. Valore restituito: nessuno Imposta il tipo di cursore del mouse mostrato al passaggio del mouse.
setDraggable	setDraggable(flag) Parametri: flag: boolean optional se true, l'indicatore può essere trascinato. Valore restituito: nessuno Imposta se Marker è trascinabile.
setIcon	setIcon([icon]) Parametri: icon: string|Icon|Symbol optional Valore restituito: nessuno Imposta l'icona per Marker. Leggi i MarkerOptions.icon.
setLabel	setLabel([label]) Parametri: label: string|MarkerLabel optional l'etichetta può essere una stringa di caratteri o un oggetto MarkerLabel. Valore restituito: nessuno Imposta l'etichetta per Marker. Leggi i MarkerOptions.label.
setMap	setMap(map) Parametri: map: Map|StreetViewPanorama optional Valore restituito: nessuno Esegue il rendering di Marker sulla mappa o sulla panoramica specificata. Se la mappa è impostata su null, l'indicatore verrà rimosso.
setOpacity	setOpacity([opacity]) Parametri: opacity: number optional un numero compreso tra 0,0 (trasparente) e 1,0 (opaco). Valore restituito: nessuno Imposta l'opacità di Marker.
setOptions	setOptions(options) Parametri: options: MarkerOptions optional Valore restituito: nessuno Imposta le opzioni per Marker.
setPosition	setPosition([latlng]) Parametri: latlng: LatLng|LatLngLiteral optional la nuova posizione. Valore restituito: nessuno Imposta la posizione per Marker.
setShape	setShape([shape]) Parametri: shape: MarkerShape optional Valore restituito: nessuno Imposta la forma del Marker utilizzato per l'interazione. Leggi i MarkerOptions.shape e la MarkerShape.
setTitle	setTitle([title]) Parametri: title: string optional Valore restituito: nessuno Imposta il titolo della descrizione comando Marker. Leggi i MarkerOptions.title.
setVisible	setVisible(visible) Parametri: visible: boolean Se true, l'indicatore è visibile Valore restituito: nessuno Imposta se Marker è visibile.
setZIndex	setZIndex([zIndex]) Parametri: zIndex: number optional Valore restituito: nessuno Imposta lo zIndex di Marker. Leggi i MarkerOptions.zIndex.
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Eventi
animation_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà di animazione Marker cambia.
click	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato quando viene fatto clic sull'icona Marker.
clickable_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà clickable di Marker cambia.
contextmenu	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato quando l'evento contextmenu DOM viene attivato su Marker
cursor_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà del cursore Marker cambia.
dblclick	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato quando si fa doppio clic sull'icona Marker.
drag	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato ripetutamente mentre l'utente trascina l'elemento Marker.
dragend	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato quando l'utente interrompe il trascinamento di Marker.
draggable_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà draggable di Marker cambia.
dragstart	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato quando l'utente inizia a trascinare l'elemento Marker.
flat_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà flat Marker cambia.
icon_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà dell'icona Marker cambia.
mousedown	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato per un mousedown su Marker.
mouseout	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato quando il mouse esce dall'area dell'icona Marker.
mouseover	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato quando il mouse entra nell'area dell'icona Marker.
mouseup	function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato per un mouseup su Marker.
position_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà della posizione Marker cambia.
shape_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà della forma Marker cambia.
title_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà del titolo Marker cambia.
visible_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà visibile Marker cambia.
zindex_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà zIndex di Marker cambia.
rightclick	Ritirato: utilizza l'evento Marker.contextmenu per supportare pattern di utilizzo come Ctrl+clic su macOS. function(event) Argomenti: event: MapMouseEvent optional Questo evento viene attivato per un clic con il tasto destro del mouse su Marker.

Interfaccia MarkerOptions

Interfaccia google.maps.MarkerOptions

Ritirato: a partire dal 21 febbraio 2024, google.maps.Marker verrà ritirato. Utilizza invece google.maps.marker.AdvancedMarkerElement. Per informazioni dettagliate sul ritiro, consulta la pagina https://developers.google.com/maps/deprecations e per la guida alla migrazione, consulta la pagina https://developers.google.com/maps/documentation/javascript/advanced-markers/migration.

Oggetto MarkerOptions utilizzato per definire le proprietà che possono essere impostate su un indicatore.

Proprietà
anchorPoint facoltativo	Tipo: Point optional L'offset dalla posizione dell'indicatore alla punta di un InfoWindow aperto con l'indicatore come ancora.
animation facoltativo	Tipo: Animation optional Valore predefinito: null L'animazione da riprodurre quando l'indicatore viene aggiunto a una mappa.
clickable facoltativo	Tipo: boolean optional Valore predefinito: true Se true, l'indicatore riceve eventi del mouse e touch.
collisionBehavior facoltativo	Deprecato: collisionBehavior è deprecato a partire da luglio 2023. Usa invece il descrittore AdvancedMarkerElement.collisionBehavior. Avviso: disponibile solo nel canale beta. Tipo: string|CollisionBehavior optional Valore predefinito: null Imposta un comportamento della sovrapposizione per gli indicatori sulle mappe vettoriali.
crossOnDrag facoltativo	Tipo: boolean optional Valore predefinito: true Se false, disattiva la croce che appare sotto l'indicatore durante il trascinamento.
cursor facoltativo	Tipo: string optional Valore predefinito: pointer Tipo di cursore del mouse da mostrare al passaggio del mouse.
draggable facoltativo	Tipo: boolean optional Valore predefinito: false Se true, l'indicatore può essere trascinato. Nota: se imposti questa opzione su true, l'indicatore sarà selezionabile anche se clickable è impostato su false.
icon facoltativo	Tipo: string|Icon|Symbol optional Icona per il primo piano. Se viene fornita una stringa, viene trattata come se fosse un Icon con la stringa come url.
label facoltativo	Tipo: string|MarkerLabel optional Valore predefinito: null Aggiunge un'etichetta all'indicatore. Un'etichetta di un indicatore è una lettera o un numero visualizzato all'interno di un indicatore. L'etichetta può essere una stringa o un oggetto MarkerLabel. Se fornito e MarkerOptions.title non è fornito, al marker verrà aggiunto un testo di accessibilità (ad es. per l'utilizzo con gli screen reader) con il testo dell'etichetta fornita. Tieni presente che al momento label viene utilizzato solo per il testo di accessibilità per gli indicatori non ottimizzati.
map facoltativo	Tipo: Map|StreetViewPanorama optional Mappa su cui visualizzare l'indicatore. La mappa è necessaria per visualizzare l'indicatore e può essere fornita con Marker.setMap se non viene fornita durante la creazione dell'indicatore.
opacity facoltativo	Tipo: number optional Valore predefinito: 1.0 Un numero compreso tra 0,0 (trasparente) e 1,0 (opaco).
optimized facoltativo	Tipo: boolean optional L'ottimizzazione migliora le prestazioni eseguendo il rendering di molti indicatori come un singolo elemento statico. Questo è utile nei casi in cui è necessario un numero elevato di indicatori. Scopri di più sull'ottimizzazione degli indicatori. Nota: questa ottimizzazione non ha alcun effetto sugli indicatori nelle mappe vettoriali.
position facoltativo	Tipo: LatLng|LatLngLiteral optional Imposta la posizione dell'indicatore. Un indicatore può essere creato, ma non visualizzato finché non viene fornita la sua posizione, ad esempio tramite le azioni o le scelte di un utente. Se non viene fornita durante la creazione dell'indicatore, la posizione dell'indicatore può essere fornita con Marker.setPosition.
shape facoltativo	Tipo: MarkerShape optional Definizione della regione della mappa immagine utilizzata per il trascinamento/clic.
title facoltativo	Tipo: string optional Valore predefinito: undefined Testo di rollover. Se fornito, al segnaposto verrà aggiunto un testo di accessibilità (ad es. da utilizzare con gli screen reader) con il valore fornito. Tieni presente che al momento title viene utilizzato solo per il testo di accessibilità per gli indicatori non ottimizzati.
visible facoltativo	Tipo: boolean optional Valore predefinito: true Se true, l'indicatore è visibile.
zIndex facoltativo	Tipo: number optional Tutti gli indicatori vengono visualizzati sulla mappa in ordine di zIndex, con i valori più alti visualizzati davanti agli indicatori con valori più bassi. Per impostazione predefinita, gli indicatori vengono visualizzati in base alla loro posizione verticale sullo schermo, con gli indicatori più in basso che appaiono davanti a quelli più in alto.

Costanti CollisionBehavior

google.maps.CollisionBehavior libreria di costanti
"marker"

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo CollisionBehaviorString.

const {CollisionBehavior} = await google.maps.importLibrary("marker");

Costanti
OPTIONAL_AND_HIDES_LOWER_PRIORITY	Mostra l'indicatore solo se non si sovrappone ad altri indicatori. Se due indicatori di questo tipo si sovrappongono, viene mostrato quello con il valore zIndex più alto. Se hanno lo stesso zIndex, viene mostrato quello con la posizione verticale più bassa sullo schermo.
REQUIRED	Mostra sempre l'indicatore indipendentemente dalla collisione. Questo è il comportamento predefinito.
REQUIRED_AND_HIDES_OPTIONAL	Mostra sempre l'indicatore indipendentemente dalla collisione e nascondi eventuali indicatori o etichette OPTIONAL_AND_HIDES_LOWER_PRIORITY che si sovrapporrebbero all'indicatore.

Interfaccia Icon

Interfaccia google.maps.Icon

Una struttura che rappresenta un'immagine dell'icona di un indicatore.

Proprietà
url	Tipo: string L'URL dell'immagine o dello sprite sheet.
anchor facoltativo	Tipo: Point optional La posizione in cui ancorare un'immagine in corrispondenza della posizione dell'indicatore sulla mappa. Per impostazione predefinita, l'ancoraggio si trova lungo il punto centrale della parte inferiore dell'immagine.
labelOrigin facoltativo	Tipo: Point optional L'origine dell'etichetta rispetto all'angolo in alto a sinistra dell'immagine dell'icona, se un'etichetta viene fornita dal marker. Per impostazione predefinita, l'origine si trova nel punto centrale dell'immagine.
origin facoltativo	Tipo: Point optional La posizione dell'immagine all'interno di uno sprite, se presente. Per impostazione predefinita, l'origine si trova nell'angolo in alto a sinistra dell'immagine (0, 0).
scaledSize facoltativo	Tipo: Size optional Le dimensioni dell'intera immagine dopo la scalabilità, se applicata. Utilizza questa proprietà per allungare/restringere un'immagine o uno sprite.
size facoltativo	Tipo: Size optional Le dimensioni di visualizzazione dello sprite o dell'immagine. Quando utilizzi gli sprite, devi specificarne le dimensioni. Se le dimensioni non vengono fornite, verranno impostate al caricamento dell'immagine.

Interfaccia MarkerLabel

Interfaccia google.maps.MarkerLabel

Queste opzioni specificano l'aspetto di un'etichetta dell'indicatore. Un'etichetta dell'indicatore è una stringa (spesso un singolo carattere) che viene visualizzata all'interno dell'indicatore. Se lo utilizzi con un indicatore personalizzato, puoi riposizionarlo con la proprietà labelOrigin nella classe Icon.

Proprietà
text	Tipo: string Il testo da visualizzare nell'etichetta.
className facoltativo	Tipo: string optional Valore predefinito: '' (stringa vuota) La proprietà className dell'elemento dell'etichetta (equivalente all'attributo class dell'elemento). È possibile aggiungere più classi CSS separate da spazi. Il colore, la dimensione, lo spessore e la famiglia del carattere possono essere impostati solo tramite le altre proprietà di MarkerLabel. Le classi CSS non devono essere utilizzate per modificare la posizione o l'orientamento dell'etichetta (ad esempio utilizzando traslazioni e rotazioni) se utilizzi anche la gestione delle collisioni dei segnaposto.
color facoltativo	Tipo: string optional Valore predefinito: 'black' Il colore del testo dell'etichetta.
fontFamily facoltativo	Tipo: string optional La famiglia di caratteri del testo dell'etichetta (equivalente alla proprietà CSS font-family).
fontSize facoltativo	Tipo: string optional Valore predefinito: '14px' La dimensione del carattere del testo dell'etichetta (equivalente alla proprietà CSS font-size).
fontWeight facoltativo	Tipo: string optional Lo spessore del carattere del testo dell'etichetta (equivalente alla proprietà CSS font-weight).

Interfaccia MarkerShape

Interfaccia google.maps.MarkerShape

Questo oggetto definisce l'area cliccabile di un'immagine dell'indicatore. La forma è costituita da due proprietà, type e coord, che definiscono la regione non trasparente di un'immagine.

Proprietà
type	Tipo: string Descrive il tipo di forma e può essere circle, poly o rect.
coords facoltativo	Tipo: Array<number> optional Il formato di questo attributo dipende dal valore di type e segue la specifica AREA coords di w3 disponibile all'indirizzo http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. L'attributo coords è un array di numeri interi che specificano la posizione in pixel della forma rispetto all'angolo in alto a sinistra dell'immagine di destinazione. Le coordinate dipendono dal valore di type come segue:   - circle: coords è [x1,y1,r] dove x1,y2 sono le coordinate del centro del cerchio e r è il raggio del cerchio.   - poly: coords è [x1,y1,x2,y2...xn,yn], dove ogni coppia x,y contiene le coordinate di un vertice del poligono.   - rect: coords è [x1,y1,x2,y2], dove x1,y1 sono le coordinate dell'angolo in alto a sinistra del rettangolo e x2,y2 sono le coordinate dell'angolo in basso a destra del rettangolo.

Interfaccia Symbol

Interfaccia google.maps.Symbol

Descrive un simbolo, costituito da un percorso vettoriale con stile. Un simbolo può essere utilizzato come icona di un indicatore o posizionato su una polilinea.

Proprietà
path	Tipo: SymbolPath|string Il percorso del simbolo, che è un percorso del simbolo integrato o un percorso personalizzato espresso utilizzando la notazione del percorso SVG. Obbligatorio.
anchor facoltativo	Tipo: Point optional Valore predefinito: google.maps.Point(0,0) La posizione del simbolo rispetto all'indicatore o alla polilinea. Le coordinate del percorso del simbolo vengono traslate a sinistra e in alto rispettivamente in base alle coordinate x e y dell'ancoraggio. La posizione è espressa nello stesso sistema di coordinate del percorso del simbolo.
fillColor facoltativo	Tipo: string optional Il colore di riempimento del simbolo. Sono supportati tutti i colori CSS3, ad eccezione dei colori con nome esteso. Per gli indicatori dei simboli, il valore predefinito è "black". Per i simboli sulle polilinee, il valore predefinito è il colore del tratto della polilinea corrispondente.
fillOpacity facoltativo	Tipo: number optional Valore predefinito: 0 L'opacità di riempimento del simbolo.
labelOrigin facoltativo	Tipo: Point optional Valore predefinito: google.maps.Point(0,0) L'origine dell'etichetta rispetto all'origine del percorso, se l'etichetta è fornita dall'indicatore. L'origine è espressa nello stesso sistema di coordinate del percorso del simbolo. Questa proprietà non viene utilizzata per i simboli sulle polilinee.
rotation facoltativo	Tipo: number optional Valore predefinito: 0 L'angolo di rotazione del simbolo, espresso in gradi in senso orario. Un simbolo in un IconSequence in cui fixedRotation è false viene ruotato rispetto all'angolo del bordo su cui si trova.
scale facoltativo	Tipo: number optional La quantità di ridimensionamento del simbolo. Per gli indicatori dei simboli, il valore predefinito è 1; dopo la scalabilità, il simbolo può essere di qualsiasi dimensione. Per i simboli su una polilinea, il valore predefinito è lo spessore del tratto della polilinea; dopo la scalabilità, il simbolo deve trovarsi all'interno di un quadrato di 22 pixel centrato sull'ancoraggio del simbolo.
strokeColor facoltativo	Tipo: string optional Il colore del tratto del simbolo. Sono supportati tutti i colori CSS3, ad eccezione dei colori con nome esteso. Per gli indicatori dei simboli, il valore predefinito è "black". Per i simboli su una polilinea, il valore predefinito è il colore del tratto della polilinea.
strokeOpacity facoltativo	Tipo: number optional L'opacità del tratto del simbolo. Per gli indicatori dei simboli, il valore predefinito è 1. Per i simboli su una polilinea, il valore predefinito è l'opacità del tratto della polilinea.
strokeWeight facoltativo	Tipo: number optional Predefinito: il Symbol.scale del simbolo. Lo spessore del tratto del simbolo.

Costanti SymbolPath

google.maps.SymbolPath libreria di costanti
"core"

Percorsi dei simboli integrati.

const {SymbolPath} = await google.maps.importLibrary("core");

Costanti
BACKWARD_CLOSED_ARROW	Una freccia chiusa rivolta verso sinistra.
BACKWARD_OPEN_ARROW	Una freccia aperta rivolta verso sinistra.
CIRCLE	Un cerchio.
FORWARD_CLOSED_ARROW	Una freccia chiusa rivolta in avanti.
FORWARD_OPEN_ARROW	Una freccia aperta rivolta in avanti.

Costanti di animazione

google.maps.Animation libreria di costanti
"marker"

Animazioni che possono essere riprodotte su un indicatore. Utilizza il metodo Marker.setAnimation su Marker o l'opzione MarkerOptions.animation per riprodurre un'animazione.

const {Animation} = await google.maps.importLibrary("marker");

Costanti
BOUNCE	Il marker rimbalza finché l'animazione non viene interrotta chiamando Marker.setAnimation con null.
DROP	L'indicatore scende dalla parte superiore della mappa alla sua posizione finale. L'animazione si interrompe quando l'indicatore si ferma e Marker.getAnimation restituisce null. Questo tipo di animazione viene solitamente specificato durante la creazione dell'indicatore.