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.
Costruttore | |
---|---|
Marker |
Marker([opts]) Parametri:
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
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:
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:
Valore restituito: nessuno
Da impostare se Marker è cliccabile. |
setCursor |
setCursor([cursor]) Parametri:
Valore restituito: nessuno
Imposta il tipo di cursore del mouse visualizzato al passaggio del mouse. |
setDraggable |
setDraggable(flag) Parametri:
Valore restituito: nessuno
Imposta se Marker è trascinabile. |
setIcon |
setIcon([icon]) Valore restituito: nessuno
Imposta l'icona per Marker . Leggi i MarkerOptions.icon . |
setLabel |
setLabel([label]) Parametri:
Valore restituito: nessuno
Imposta l'etichetta per Marker . Leggi i MarkerOptions.label . |
setMap |
setMap(map) Parametri:
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:
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 per Marker . |
setShape |
setShape([shape]) Parametri:
Valore restituito: nessuno
Imposta la forma di Marker utilizzata per l'interazione. Leggi i MarkerOptions.shape e le MarkerShape . |
setTitle |
setTitle([title]) Parametri:
Valore restituito: nessuno
Imposta il titolo della descrizione comando Marker . Leggi i MarkerOptions.title . |
setVisible |
setVisible(visible) Parametri:
Valore restituito: nessuno
Imposta se Marker è visibile. |
setZIndex |
setZIndex([zIndex]) Parametri:
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:
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:
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:
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 viene modificata. |
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à flat 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à 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. |
|
function(event) Argomenti:
Questo evento viene attivato per un clic con il tasto destro del mouse su Marker . |
Interfaccia di MarkerOptions
Interfaccia google.maps.MarkerOptions
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. |
|
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 |
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. |