Marker

Classe Marker

google.maps.Marker classe

Questa classe estende MVCObject.

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

Marker
Marker([opts])
Parametri: 
Crea un indicatore con le opzioni specificate. Se viene specificata una mappa, l'indicatore viene aggiunto alla mappa al momento della costruzione. Tieni presente che la posizione deve essere impostata affinché l'indicatore venga visualizzato.
MAX_ZINDEX Lo z-index predefinito massimo che l'API assegna a un indicatore. Puoi impostare uno z-index più alto per portare un indicatore in primo piano.
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
Consente di visualizzare il tipo di cursore del mouse che appare 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 di Marker. Leggi i MarkerOptions.label.
getMap
getMap()
Parametri: nessuno
Valore restituito:  Map|StreetViewPanorama
Visualizza la mappa o il panorama su cui viene visualizzato 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 dell'evento Marker.
getShape
getShape()
Parametri: nessuno
Valore restituito:  MarkerShape|null|undefined
Visualizza la forma dell'elemento Marker utilizzato per l'interazione. Leggi i MarkerOptions.shape e l'MarkerShape.
getTitle
getTitle()
Parametri: nessuno
Valore restituito:  string|null|undefined
Recupera 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: 
  • animationAnimation 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. Il passaggio in null causerà l'interruzione dell'animazione.
setClickable
setClickable(flag)
Parametri: 
  • flagboolean se true, è possibile fare clic sull'indicatore.
Valore restituito: nessuno
Da impostare se Marker è cliccabile.
setCursor
setCursor([cursor])
Parametri: 
  • cursorstring optional tipo di cursore del mouse.
Valore restituito: nessuno
Imposta il tipo di cursore del mouse che viene mostrato al passaggio del mouse.
setDraggable
setDraggable(flag)
Parametri: 
  • flagboolean optional Se true, l'indicatore può essere trascinato.
Valore restituito: nessuno
Imposta se Marker può essere trascinato.
setIcon
setIcon([icon])
Parametri: 
Valore restituito: nessuno
Imposta l'icona di Marker. Leggi i MarkerOptions.icon.
setLabel
setLabel([label])
Parametri: 
  • labelstring|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: 
Valore restituito: nessuno
Visualizza Marker sulla mappa o sulla panoramica specificati. Se la mappa è impostata su null, l'indicatore verrà rimosso.
setOpacity
setOpacity([opacity])
Parametri: 
  • opacitynumber optional un numero compreso tra 0,0, trasparente e 1,0, opaco.
Valore restituito: nessuno
Imposta l'opacità di Marker.
setOptions
setOptions(options)
Parametri: 
Valore restituito: nessuno
Imposta le opzioni per Marker.
setPosition
setPosition([latlng])
Parametri: 
Valore restituito: nessuno
Imposta la posizione di Marker.
setShape
setShape([shape])
Parametri: 
Valore restituito: nessuno
Consente di impostare la forma dell'elemento Marker utilizzato per l'interazione. Leggi i MarkerOptions.shape e l'MarkerShape.
setTitle
setTitle([title])
Parametri: 
  • titlestring optional
Valore restituito: nessuno
Imposta il titolo della descrizione comando Marker. Leggi i MarkerOptions.title.
setVisible
setVisible(visible)
Parametri: 
  • visibleboolean Se true, l'indicatore è visibile
Valore restituito: nessuno
Imposta se Marker è visibile.
setZIndex
setZIndex([zIndex])
Parametri: 
  • zIndexnumber optional
Valore restituito: nessuno
Imposta il valore zIndex di Marker. Leggi i MarkerOptions.zIndex.
Ereditati: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
animation_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà dell'animazione Marker cambia.
click
function(event)
Argomenti: 
Questo evento viene attivato quando viene fatto clic sull'icona Marker.
clickable_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà cliccabile Marker cambia.
contextmenu
function(event)
Argomenti: 
Questo evento viene attivato quando l'evento del menu contestuale 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: 
Questo evento viene attivato quando è stato fatto doppio clic sull'icona Marker.
drag
function(event)
Argomenti: 
Questo evento viene attivato ripetutamente mentre l'utente trascina Marker.
dragend
function(event)
Argomenti: 
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 cambia.
dragstart
function(event)
Argomenti: 
Questo evento viene attivato quando l'utente inizia a trascinare Marker.
flat_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà semplice Marker viene modificata.
icon_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà dell'icona Marker cambia.
mousedown
function(event)
Argomenti: 
Questo evento viene attivato per un mousedown su Marker.
mouseout
function(event)
Argomenti: 
Questo evento viene attivato quando il mouse si allontana dall'area dell'icona Marker.
mouseover
function(event)
Argomenti: 
Questo evento viene attivato quando il mouse entra nell'area dell'icona Marker.
mouseup
function(event)
Argomenti: 
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à 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 Marker cambia.
rightclick
function(event)
Argomenti: 
Questo evento viene attivato per un clic con il tasto destro del mouse su Marker.

Interfaccia MarkerOptions

Interfaccia google.maps.MarkerOptions

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

anchorPoint optional
Tipo:  Point optional
L'offset dalla posizione dell'indicatore alla punta di una finestra informativa che è stata aperta con l'indicatore come ancoraggio.
animation optional
Tipo:  Animation optional
Valore predefinito: null
Animazione da riprodurre quando un indicatore viene aggiunto a una mappa.
clickable optional
Tipo:  boolean optional
Valore predefinito: true
Se true, l'indicatore riceve eventi di tocco e mouse.
BetacollisionBehavior optional
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, è 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
Valore predefinito: null
Aggiunge un'etichetta all'indicatore. L'etichetta di un indicatore è una lettera o un numero presente all'interno di un indicatore. L'etichetta può essere una stringa o un oggetto MarkerLabel. Se fornito e MarkerOptions.title non è fornito, un testo sull'accessibilità (ad esempio per l'uso con screen reader) verrà aggiunto all'indicatore con il testo dell'etichetta fornito. Tieni presente che label viene attualmente utilizzato solo per il testo sull'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
Valore predefinito: 1.0
Un numero compreso tra 0,0, trasparente e 1,0, opaco.
optimized optional
Tipo:  boolean optional
L'ottimizzazione migliora il rendimento eseguendo il rendering di molti indicatori come un 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
Consente di impostare la posizione dell'indicatore. Un indicatore può essere costruito, ma non visualizzato finché non viene fornita la sua posizione, ad esempio in base alle azioni o alle 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
Valore predefinito: undefined
Testo del rollback. Se fornito, all'indicatore verrà aggiunto un testo sull'accessibilità (ad esempio per l'uso con screen reader) con il valore fornito. Tieni presente che title viene attualmente utilizzato solo per il testo sull'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 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 più in basso vengono visualizzati davanti agli indicatori più in alto sullo schermo.

Costanti di comportamento di collisione

google.maps.CollisionBehavior costanti

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

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 zIndex più elevato. Se hanno lo stesso zIndex, viene mostrato quello con la posizione verticale più bassa dello 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 o le etichette OPTIONAL_AND_HIDES_LOWER_PRIORITY che si sovrappongono all'indicatore.

Interfaccia dell'icona

Interfaccia google.maps.Icon

Una struttura che rappresenta un'immagine dell'icona Indicatore.

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 in alto a sinistra dell'immagine dell'icona, se un'etichetta è fornita dall'indicatore. 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 estendere/restringere 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 vengono specificate le dimensioni, queste verranno impostate 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 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.

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. Colore, dimensioni, spessore e famiglia dei caratteri 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 es. utilizzando traslazioni e rotazioni) se si utilizza anche la gestione dei 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à della famiglia di caratteri del CSS).
fontSize optional
Tipo:  string optional
Valore predefinito: '14px'
La dimensione del carattere del testo dell'etichetta (equivalente alla proprietà font-size del CSS).
fontWeight optional
Tipo:  string optional
Lo spessore del carattere del testo dell'etichetta (equivalente alla proprietà dello spessore del carattere del CSS).

Interfaccia MarkerShape

Interfaccia google.maps.MarkerShape

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

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 in questo modo:
- 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 sono [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 superiore sinistro del rettangolo e x2,y2 sono le coordinate del rettangolo in basso a destra.
type
Tipo:  string
Descrive il tipo di forma. Può essere circle, poly o rect.

Interfaccia di un 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 oppure posizionato su una polilinea.

path
Tipo:  SymbolPath|string
Il percorso del simbolo, che è un percorso di simbolo integrato, o un percorso personalizzato espresso usando la notazione dei percorsi 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 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, l'impostazione predefinita è il colore del tratto della polilinea corrispondente.
fillOpacity optional
Tipo:  number optional
Valore predefinito: 0
L'opacità di 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 è 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
La quantità di scala del simbolo. Per gli indicatori di simboli, il valore predefinito è 1; dopo il ridimensionamento, il simbolo può avere qualsiasi dimensione. Per i simboli su una polilinea, il valore predefinito è lo 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, l'impostazione predefinita è 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.
Il peso 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.

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 dell'animazione

google.maps.Animation costanti

Animazioni riproducibili su un indicatore. Usa il metodo Marker.setAnimation sull'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.

BOUNCE L'indicatore torna indietro 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 cesserà una volta che l'indicatore si fermerà e Marker.getAnimation restituirà null. Questo tipo di animazione viene solitamente specificato durante la creazione dell'indicatore.