Marker (legacy)

Classe Marker

google.maps.Marker classe

Ritirato:a partire dal 21 febbraio 2024, l'app google.maps.Marker è stata ritirata. Utilizza AdvancedMarkerElement. Al momento non è prevista la disattivazione di google.maps.Marker, ma AdvancedMarkerElement è consigliato rispetto a google.maps.Marker. Anche se google.maps.Marker continuerà a ricevere correzioni di bug per le regressioni principali, i bug esistenti in google.maps.Marker non verranno risolti. Prima dell'interruzione dell'assistenza, verrà dato un preavviso di almeno 12 mesi. Vedi https://developers.google.com/maps/deprecations per ulteriori dettagli e https://developers.google.com/maps/documentation/javascript/advanced-markers/migration per consultare la guida alla migrazione.

Questa classe estende MVCObject.

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

Costruttore
Marker	Marker([opts]) Parametri:  opts:  MarkerOptions optional argomenti facoltativi denominati Crea un indicatore con le opzioni specificate. Se si specifica una mappa, l'indicatore viene aggiunto alla mappa al momento della costruzione. Tieni presente che la posizione deve essere impostata per visualizzare l'indicatore.

Costanti
MAX_ZINDEX	Lo z-index predefinito massimo che l'API assegna a un indicatore. Puoi impostare uno z-index più alto per portare in primo piano un indicatore.

Metodi
getAnimation	getAnimation() Parametri: nessuno Valore restituito:  Animation|null|undefined Scarica l'animazione attualmente in esecuzione.
getClickable	getClickable() Parametri: nessuno Valore restituito:  boolean true se l'indicatore è cliccabile. Visualizza lo stato cliccabile di Marker.
getCursor	getCursor() Parametri: nessuno Valore restituito:  string|null|undefined Visualizza il tipo di cursore del mouse mostrato al passaggio del mouse.
getDraggable	getDraggable() Parametri: nessuno Valore restituito:  boolean true se l'indicatore è trascinabile. Visualizza lo stato trascinabile di Marker.
getIcon	getIcon() Parametri: nessuno Valore restituito:  string|Icon|Symbol|null|undefined Ottieni l'icona di Marker. Leggi i MarkerOptions.icon.
getLabel	getLabel() Parametri: nessuno Valore restituito:  MarkerLabel|string|null|undefined Ottieni l'etichetta del Marker. Leggi i MarkerOptions.label.
getMap	getMap() Parametri: nessuno Valore restituito:  Map|StreetViewPanorama Visualizza la mappa o panaroama su cui viene visualizzata la Marker.
getOpacity	getOpacity() Parametri: nessuno Valore restituito:  number|null|undefined un numero compreso tra 0,0 e 1,0. Ottieni l'opacità di Marker.
getPosition	getPosition() Parametri: nessuno Valore restituito:  LatLng|null|undefined Ottieni la posizione di Marker.
getShape	getShape() Parametri: nessuno Valore restituito:  MarkerShape|null|undefined Ottieni la forma di Marker utilizzata per l'interazione. Leggi i MarkerOptions.shape e le MarkerShape.
getTitle	getTitle() Parametri: nessuno Valore restituito:  string|null|undefined Ottieni il titolo della descrizione comando Marker. Leggi i MarkerOptions.title.
getVisible	getVisible() Parametri: nessuno Valore restituito:  boolean true se l'indicatore è visibile. Ottieni la visibilità di Marker.
getZIndex	getZIndex() Parametri: nessuno Valore restituito:  number|null|undefined zIndex dell'indicatore. Ottieni il valore 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 e Animation.DROP. Se superi l'intervallo di tempo null, qualsiasi animazione verrà interrotta.
setClickable	setClickable(flag) Parametri:  flag:  boolean Se true è possibile fare clic sull'indicatore. Valore restituito: nessuno Da impostare se Marker è cliccabile.
setCursor	setCursor([cursor]) Parametri:  cursor:  string optional tipo di cursore del mouse. Valore restituito: nessuno Imposta il tipo di cursore del mouse visualizzato 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 Valore restituito: nessuno Visualizza il Marker sulla mappa o sul panorama specificati. 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 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 di Marker utilizzata per l'interazione. Leggi i MarkerOptions.shape e le 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 il valore 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à dell'animazione Marker cambia.
click	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'utente ha fatto clic sull'icona Marker.
clickable_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà cliccabile Marker cambia.
contextmenu	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'evento del menu di contesto 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 Questo evento viene attivato quando è stato fatto doppio clic sull'icona Marker.
drag	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato ripetutamente mentre l'utente trascina Marker.
dragend	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'utente smette di trascinare Marker.
draggable_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà trascinabile Marker viene modificata.
dragstart	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'utente inizia a trascinare Marker.
flat_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà flat Marker viene modificata.
icon_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà dell'icona Marker cambia.
mousedown	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato per un mousedown su Marker.
mouseout	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando il mouse si allontana dall'area dell'icona Marker.
mouseover	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando il mouse entra nell'area dell'icona Marker.
mouseup	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato per un mouseup su Marker.
position_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà di 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 viene modificata.
rightclick	Deprecato: utilizza l'evento Marker.contextmenu per supportare pattern di utilizzo come Ctrl-clic su macOS. function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato per un clic con il tasto destro del mouse su Marker.

Interfaccia di MarkerOptions

Interfaccia google.maps.MarkerOptions

Ritirato:a partire dal 21 febbraio 2024, l'app google.maps.Marker è stata ritirata. Utilizza invece google.maps.marker.AdvancedMarkerElement. Consulta https://developers.google.com/maps/deprecations per conoscere i dettagli sul ritiro e https://developers.google.com/maps/documentation/javascript/advanced-markers/migration per consultare la guida alla migrazione.

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

Proprietà
anchorPoint optional	Tipo:  Point optional Lo scostamento dalla posizione dell'indicatore alla punta di una finestra informativa che è stata aperta con l'indicatore come ancoraggio.
animation optional	Tipo:  Animation optional Predefinita: null Animazione da riprodurre quando un indicatore viene aggiunto a una mappa.
clickable optional	Tipo:  boolean optional Predefinita: true Se true, l'indicatore riceve eventi di tocco e mouse.
collisionBehavior optional	Deprecato: collisionBehavior è deprecato a partire da luglio 2023. Usa invece il criterio AdvancedMarkerElement.collisionBehavior. Avviso: disponibile soltanto nel canale v=beta. Tipo:  string|CollisionBehavior optional Predefinita: null Imposta un comportamento di collisione per gli indicatori sulle mappe vettoriali.
crossOnDrag optional	Tipo:  boolean optional Predefinita: true Se false, disattiva la croce visualizzata sotto l'indicatore durante il trascinamento.
cursor optional	Tipo:  string optional Predefinita: pointer Tipo di cursore del mouse da mostrare al passaggio del mouse.
draggable optional	Tipo:  boolean optional Predefinita: false Se true, è possibile trascinare l'indicatore.
icon optional	Tipo:  string|Icon|Symbol optional Icona per il primo piano. Se viene fornita una stringa, viene considerata come se fosse un Icon con la stringa come url.
label optional	Tipo:  string|MarkerLabel optional Predefinita: null Aggiunge un'etichetta all'indicatore. L'etichetta di un indicatore è una lettera o un numero che compare all'interno di un indicatore. L'etichetta può essere una stringa o un oggetto MarkerLabel. Se fornito e MarkerOptions.title non viene fornito, all'indicatore verrà aggiunto un testo di accessibilità (ad esempio per l'uso con screen reader) con il testo dell'etichetta fornita. Tieni presente che label viene attualmente utilizzato solo per il testo di accessibilità per gli indicatori non ottimizzati.
map optional	Tipo:  Map|StreetViewPanorama optional Mappa sulla quale 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 optional	Tipo:  number optional Predefinito:1,0 Un numero compreso tra 0,0, trasparente e 1,0, opaco.
optimized optional	Tipo:  boolean optional L'ottimizzazione migliora le prestazioni eseguendo il rendering di molti indicatori come singolo elemento statico. Questa opzione è utile nei casi in cui è richiesto un numero elevato di indicatori. Scopri di più sull'ottimizzazione degli indicatori.
position optional	Tipo:  LatLng|LatLngLiteral optional Imposta la posizione dell'indicatore. Un indicatore può essere creato ma non visualizzato finché la sua posizione non viene fornita, ad esempio dalle azioni o dalle scelte di un utente. La posizione dell'indicatore può essere fornita con Marker.setPosition se non viene fornita durante la creazione dell'indicatore.
shape optional	Tipo:  MarkerShape optional Definizione della regione della mappa immagine utilizzata per il trascinamento.
title optional	Tipo:  string optional Predefinita: undefined Testo del passaggio del mouse. Se fornito, viene aggiunto all'indicatore un testo di accessibilità (ad esempio da utilizzare con gli screen reader) con il valore fornito. Tieni presente che title viene attualmente utilizzato solo per il testo di accessibilità per gli indicatori non ottimizzati.
visible optional	Tipo:  boolean optional Predefinita: true Se true, l'indicatore è visibile.
zIndex optional	Tipo:  number optional Tutti gli indicatori vengono visualizzati sulla mappa in ordine 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, mentre gli indicatori inferiori vengono visualizzati davanti agli indicatori più in alto sullo schermo.

Costanti di CollisionBehavior

google.maps.CollisionBehavior costanti

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

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

Interfaccia icona

Interfaccia google.maps.Icon

Una struttura che rappresenta l'immagine di un'icona Indicatore.

Proprietà
url	Tipo:  string L'URL dell'immagine o del foglio sprite.
anchor optional	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 optional	Tipo:  Point optional L'origine dell'etichetta rispetto all'angolo superiore sinistro dell'immagine dell'icona, se l'indicatore fornisce un'etichetta. Per impostazione predefinita, l'origine si trova nel punto centrale dell'immagine.
origin optional	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 optional	Tipo:  Size optional Le dimensioni dell'intera immagine dopo l'eventuale ridimensionamento. Utilizza questa proprietà per estendere/ridurre un'immagine o uno sprite.
size optional	Tipo:  Size optional Le dimensioni di visualizzazione dello sprite o dell'immagine. Quando utilizzi gli sprite, devi specificare le dimensioni dello sprite. Se non viene fornita la dimensione, verrà impostata al caricamento dell'immagine.

Interfaccia MarkerLabel

Interfaccia google.maps.MarkerLabel

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

Proprietà
text	Tipo:  string Il testo da visualizzare nell'etichetta.
className optional	Tipo:  string optional 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, le dimensioni, 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 cambiare la posizione o l'orientamento dell'etichetta (ad es. utilizzando traduzioni e rotazioni) se si utilizza anche la gestione dei conflitti degli indicatori.
color optional	Tipo:  string optional Predefinita: 'black' Il colore del testo dell'etichetta.
fontFamily optional	Tipo:  string optional La famiglia di caratteri del testo dell'etichetta (equivalente alla proprietà della famiglia di caratteri CSS).
fontSize optional	Tipo:  string optional Predefinita: '14px' Le dimensioni del carattere del testo dell'etichetta (equivalente alla proprietà della dimensione carattere del CSS).
fontWeight optional	Tipo:  string optional Lo spessore del carattere del testo dell'etichetta (equivalente allo spessore del carattere CSS).

Interfaccia MarkerShape

Interfaccia google.maps.MarkerShape

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

Proprietà
coords	Tipo:  Array<number> Il formato di questo attributo dipende dal valore di type e segue la specifica w3 AREA coords 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 target. Le coordinate dipendono dal valore di type, come segue: - circle: le coordinate sono [x1,y1,r], dove x1,y2 sono le coordinate del centro del cerchio e r è il raggio del cerchio. - poly: le coordinate corrispondono a [x1,y1,x2,y2...xn,yn] dove ogni coppia x,y contiene le coordinate di un vertice del poligono. - rect: le coordinate sono [x1,y1,x2,y2], dove x1,y1 sono le coordinate dell'angolo in alto a sinistra del rettangolo e x2,y2 sono le coordinate delle coordinate in basso a destra del rettangolo.
type	Tipo:  string Descrive il tipo di forma. Può essere circle, poly o rect.

Interfaccia del simbolo

Interfaccia google.maps.Symbol

Descrive un simbolo, costituito da un percorso vettoriale con stili. 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 dei percorsi SVG. obbligatorio.
anchor optional	Tipo:  Point optional Predefinita: google.maps.Point(0,0) La posizione del simbolo rispetto all'indicatore o alla polilinea. Le coordinate del percorso del simbolo vengono tradotte verso sinistra e verso l'alto dalle coordinate x e y dell'ancoraggio, rispettivamente. La posizione è espressa nello stesso sistema di coordinate del percorso del simbolo.
fillColor optional	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 di simboli, l'impostazione predefinita è "nero". Per i simboli sulle polilinee, il valore predefinito corrisponde al colore del tratto della polilinea corrispondente.
fillOpacity optional	Tipo:  number optional Predefinita: 0 Opacità di riempimento del simbolo.
labelOrigin optional	Tipo:  Point optional Predefinita: 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 è utilizzata per i simboli sulle polilinee.
rotation optional	Tipo:  number optional Predefinita: 0 L'angolo di rotazione del simbolo, espresso in gradi in senso orario. Un simbolo in IconSequence in cui fixedRotation è false viene ruotato rispetto all'angolo del bordo su cui si trova.
scale optional	Tipo:  number optional La quantità di scala del simbolo. Per gli indicatori di simboli, il valore predefinito è 1; dopo il ridimensionamento, il simbolo può essere di qualsiasi dimensione. Per i simboli su una polilinea, il valore predefinito corrisponde allo spessore del tratto della polilinea; dopo il ridimensionamento, il simbolo deve trovarsi all'interno di un quadrato di 22 pixel, centrato sull'ancoraggio del simbolo.
strokeColor optional	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 di simboli, l'impostazione predefinita è "nero". Per i simboli su una polilinea, il valore predefinito è il colore del tratto della polilinea.
strokeOpacity optional	Tipo:  number optional L'opacità del tratto del simbolo. Per gli indicatori di simboli, il valore predefinito è 1. Per i simboli su una polilinea, l'impostazione predefinita è l'opacità del tratto della polilinea.
strokeWeight optional	Tipo:  number optional Predefinito:il valore Symbol.scale del simbolo. Lo spessore del tratto del simbolo.

Costanti di SymbolPath

google.maps.SymbolPath costanti

Percorsi dei simboli integrati.

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

Costanti
BACKWARD_CLOSED_ARROW	Una freccia chiusa che punta all'indietro.
BACKWARD_OPEN_ARROW	Una freccia aperta che punta all'indietro.
CIRCLE	Un cerchio.
FORWARD_CLOSED_ARROW	Una freccia chiusa che punta in avanti.
FORWARD_OPEN_ARROW	Una freccia aperta che punta in avanti.

Costanti di animazione

google.maps.Animation costanti

Animazioni riproducibili su un indicatore. Utilizza il metodo Marker.setAnimation su Indicatore o l'opzione MarkerOptions.animation per riprodurre un'animazione.

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

Costanti
BOUNCE	L'indicatore rimbalza fino all'interruzione dell'animazione chiamando Marker.setAnimation con null.
DROP	L'indicatore si sposta dalla parte superiore della mappa verso la sua posizione finale. L'animazione cesserà quando l'indicatore si fermerà e Marker.getAnimation restituirà null. Questo tipo di animazione viene solitamente specificato durante la creazione dell'indicatore.