Marker (legacy)

Indicatore class

google.maps.Marker corso

Ritiro:a partire dal 21 febbraio 2024, google.maps.Marker verrà ritirato. Utilizza AdvancedMarkerElement. Al momento, non è prevista la discontinuazione 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. Prima dell'interruzione dell'assistenza verrà inviato un preavviso di almeno 12 mesi. Per ulteriori dettagli, visita la pagina https://developers.google.com/maps/deprecations e la pagina https://developers.google.com/maps/documentation/javascript/advanced-markers/migration per 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 viene specificata una mappa, l'indicatore viene aggiunto alla mappa al momento della creazione. Tieni presente che la posizione deve essere impostata per visualizzare l'indicatore.

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

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. Visualizza lo stato di clic del Marker.
getCursor	getCursor() Parametri: nessuno Valore restituito:string|null|undefined Ottieni il tipo di cursore del mouse visualizzato al passaggio del mouse.
getDraggable	getDraggable() Parametri: nessuno Valore restituito:  boolean True se l'indicatore è trascinabile. Visualizza lo stato di trascinabilità del Marker.
getIcon	getIcon() Parametri: nessuno Valore restituito:string|Icon|Symbol|null|undefined Visualizza l'icona Marker. Leggi i MarkerOptions.icon.
getLabel	getLabel() Parametri: nessuno Valore restituito:MarkerLabel|string|null|undefined Recupera l'etichetta del Marker. Leggi i MarkerOptions.label.
getMap	getMap() Parametri: nessuno Valore restituito:Map|StreetViewPanorama Recupera la mappa o la panoramica su cui viene visualizzato Marker.
getOpacity	getOpacity() Parametri: nessuno Valore restituito:  number|null|undefined un numero compreso tra 0,0 e 1,0. Recupera l'opacità del Marker.
getPosition	getPosition() Parametri: nessuno Valore restituito:LatLng|null|undefined Recupera la posizione del Marker.
getShape	getShape() Parametri: nessuno Valore restituito:MarkerShape|null|undefined Ottieni la forma del Marker utilizzato per l'interazione. Leggi i MarkerOptions.shape e la MarkerShape.
getTitle	getTitle() Parametri: nessuno Valore restituito:string|null|undefined Recupera il titolo della descrizione comando di Marker. Leggi i MarkerOptions.title.
getVisible	getVisible() Parametri: nessuno Valore restituito:  boolean True se l'indicatore è visibile. Ottieni la visibilità del Marker.
getZIndex	getZIndex() Parametri: nessuno Valore restituito:  number|null|undefined indice z dell'indicatore. Recupera l'indice z del Marker. Leggi i MarkerOptions.zIndex.
setAnimation	setAnimation([animation]) Parametri:  animation:  Animation optional l'animazione da riprodurre. Valore restituito:nessuno Avvia un'animazione. Eventuali animazioni in corso verranno annullate. Le animazioni attualmente supportate sono: Animation.BOUNCE, Animation.DROP. Se passi null, qualsiasi animazione verrà interrotta.
setClickable	setClickable(flag) Parametri:  flag:  boolean se true, è possibile fare clic sull'indicatore. Valore restituito:nessuno Imposta 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 Mostra Marker sulla mappa o sul panorama specificato. 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à del 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 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 di 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 l'indice z del Marker. Leggi i MarkerOptions.zIndex.
Ereditato: 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 Questo evento viene attivato quando viene fatto clic sull'icona Marker.
clickable_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà Marker cliccabile cambia.
contextmenu	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando viene attivato l'evento contextmenu del DOM 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 viene fatto doppio clic sull'icona Marker.
drag	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato ripetutamente mentre l'utente trascina il Marker.
dragend	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'utente interrompe il trascinamento del Marker.
draggable_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà draggable Marker cambia.
dragstart	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando l'utente inizia a trascinare il 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 Questo evento viene attivato per un evento mousedown sul Marker.
mouseout	function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato quando il mouse esce 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 evento mouseup sul 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à Marker title cambia.
visible_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà Marker visible cambia.
zindex_changed	function() Argomenti: nessuno Questo evento viene attivato quando la proprietà Marker zIndex cambia.
rightclick	Deprecato: utilizza invece l'evento Marker.contextmenu per supportare modelli di utilizzo come il controllo-clic su macOS. function(event) Argomenti:  event:  MapMouseEvent Questo evento viene attivato per un clic con il tasto destro del mouse sul Marker.

Interfaccia MarkerOptions

google.maps.MarkerOptions interfaccia

Ritiro: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 la pagina https://developers.google.com/maps/documentation/javascript/advanced-markers/migration per la guida alla migrazione.

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

Proprietà
anchorPoint optional	Tipo:  Point optional Lo spazio dalla posizione dell'indicatore alla punta di una finestra informativa aperta con l'indicatore come ancora.
animation optional	Tipo:  Animation optional Valore predefinito: null L'animazione da riprodurre quando l'indicatore viene aggiunto a una mappa.
clickable optional	Tipo:  boolean optional Valore predefinito: true Se true, l'indicatore riceve eventi attivati con il mouse o il tocco.
collisionBehavior optional	Ritiro previsto: collisionBehavior verrà ritirato a partire da luglio 2023. Utilizza invece AdvancedMarkerElement.collisionBehavior. Avviso: disponibile solo nel canale v=beta. Tipo:  string|CollisionBehavior optional Valore predefinito: null Imposta un comportamento di collisione per gli indicatori sulle mappe vettoriali.
crossOnDrag optional	Tipo:  boolean optional Valore predefinito: true Se false, disattiva la croce visualizzata sotto l'indicatore durante il trascinamento.
cursor optional	Tipo:  string optional Valore predefinito: pointer Tipo di cursore del mouse da mostrare al passaggio del mouse.
draggable optional	Tipo:  boolean optional Valore predefinito: false Se è true, l'indicatore può essere trascinato.
icon optional	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 optional	Tipo:  string|MarkerLabel optional Valore predefinito: null Aggiunge un'etichetta all'indicatore. Un'etichetta 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 fornito. 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 su cui visualizzare l'indicatore. La mappa è obbligatoria per visualizzare l'indicatore e può essere fornita con Marker.setMap se non è stata fornita durante la creazione dell'indicatore.
opacity optional	Tipo:  number optional Valore predefinito: 1,0 Un numero compreso tra 0,0 (trasparente) e 1,0 (opaco).
optimized optional	Tipo:  boolean optional L'ottimizzazione migliora le prestazioni perché esegue 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.
position optional	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 dalle azioni o dalle scelte di un utente. Se non viene fornita al momento della creazione, la posizione di un indicatore può essere fornita con Marker.setPosition.
shape optional	Tipo:  MarkerShape optional Definizione della regione della mappa di immagini utilizzata per trascinamento/clic.
title optional	Tipo:  string optional Valore predefinito: undefined Testo del rollover. Se specificato, al marker verrà aggiunto un testo di accessibilità (ad es. per l'utilizzo 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 Valore predefinito: true Se true, l'indicatore è visibile.
zIndex optional	Tipo:  number optional Tutti gli indicatori vengono visualizzati sulla mappa in ordine di zIndex, con i valori più alti 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 costanti

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

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 visualizzato quello con l'indice z più elevato. Se hanno lo stesso z-index, viene visualizzata quella con la posizione sullo schermo verticale più bassa.
REQUIRED	Mostra sempre l'indicatore, indipendentemente dalla collisione. Questo è il comportamento predefinito.
REQUIRED_AND_HIDES_OPTIONAL	Mostra sempre l'indicatore indipendentemente dalle collisioni e nascondi eventuali indicatori o etichette OPTIONAL_AND_HIDES_LOWER_PRIORITY che si sovrappongono all'indicatore.

Interfaccia icona

google.maps.Icon interfaccia

Una struttura che rappresenta un'immagine dell'icona del marker.

Proprietà
url	Tipo:  string L'URL dell'immagine o dello sprite sheet.
anchor optional	Tipo:  Point optional La posizione in cui ancorare un'immagine in corrispondenza della posizione dell'indicatore sulla mappa. Per impostazione predefinita, l'ancora si trova lungo il punto centrale della parte inferiore dell'immagine.
labelOrigin optional	Tipo:  Point optional L'origine dell'etichetta rispetto all'angolo in alto a sinistra 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 il ridimensionamento, se presente. Utilizza questa proprietà per allungare/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 degli sprite. Se le dimensioni non vengono fornite, verranno impostate al caricamento dell'immagine.

Interfaccia MarkerLabel

google.maps.MarkerLabel interfaccia

Queste opzioni specificano l'aspetto di un'etichetta del marker. Un'etichetta del marker è una stringa (spesso un singolo carattere) che viene visualizzata all'interno del marker. 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 optional	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, le dimensioni, il peso e la famiglia di caratteri possono essere impostati solo tramite le altre proprietà di MarkerLabel. Le classi CSS non devono essere utilizzate per modificare la posizione né l'orientamento dell'etichetta (ad es. utilizzando traslazioni e rotazioni) se utilizzi anche la gestione delle collisioni degli indicatori.
color optional	Tipo:  string optional Valore predefinito: 'black' Il colore del testo dell'etichetta.
fontFamily optional	Tipo:  string optional La famiglia di caratteri del testo dell'etichetta (equivalente alla proprietà CSS font-family).
fontSize optional	Tipo:  string optional Valore predefinito: '14px' Le dimensioni del carattere del testo dell'etichetta (equivalente alla proprietà CSS font-size).
fontWeight optional	Tipo:  string optional Lo spessore del carattere del testo dell'etichetta (equivalente alla proprietà CSS font-weight).

Interfaccia MarkerShape

google.maps.MarkerShape interfaccia

Questo oggetto definisce la regione cliccabile di un'immagine del marker. La forma è composta 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 AREA coords 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.
type	Tipo:  string Descrive il tipo di forma e può essere circle, poly o rect.

Interfaccia Simbolo

google.maps.Symbol interfaccia

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 optional	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 spostate verso sinistra e verso l'alto rispettivamente per le coordinate x e y dell'ancora. 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 estesi. Per gli indicatori di simboli, il valore predefinito è "nero". Per i simboli sulle polilinee, il valore predefinito è il colore del tratto della polilinea corrispondente.
fillOpacity optional	Tipo:  number optional Valore predefinito: 0 L'opacità del riempimento del simbolo.
labelOrigin optional	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 optional	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 optional	Tipo:  number optional L'entità con cui le dimensioni del simbolo vengono ridimensionate. Per gli indicatori di simboli, il valore predefinito è 1. Dopo la scalatura, il simbolo può avere qualsiasi dimensione. Per i simboli su una polilinea, il valore predefinito è lo spessore del tratto della polilinea. Dopo la scalatura, il simbolo deve trovarsi all'interno di un quadrato di 22 pixel di dimensioni centrato sull'ancora 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 estesi. Per gli indicatori di simboli, il valore predefinito è "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 Valore predefinito:il Symbol.scale del simbolo. Lo spessore del tratto del simbolo.

Costanti 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 rivolta all'indietro.
BACKWARD_OPEN_ARROW	Una freccia aperta rivolta all'indietro.
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 costanti

Animazioni che possono essere riprodotte 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 oscilla finché l'animazione non viene interrotta chiamando Marker.setAnimation con null.
DROP	L'indicatore scende dalla parte superiore della mappa alla posizione finale. L'animazione verrà interrotta quando l'indicatore si fermerà e Marker.getAnimation restituirà null. Questo tipo di animazione viene in genere specificato durante la creazione dell'indicatore.