Un'icona posizionata in un determinato punto sulla superficie della mappa. L'icona di un indicatore viene disegnata con lo schermo del dispositivo e non con la superficie della mappa, vale a dire che non cambierà necessariamente l'orientamento a causa di rotazioni, inclinazioni o zoom della mappa.
Un indicatore ha le seguenti proprietà:
- Alpha
- Imposta l'opacità dell'indicatore. Il valore predefinito è 1,0.
- Ancora
- Il punto sull'immagine che verrà posizionato nella posizione
LatLng
dell'indicatore. Il valore predefinito è 50% dal lato sinistro dell'immagine e dalla parte inferiore dell'immagine. - Posizione
- Il valore
LatLng
della posizione dell'indicatore sulla mappa. Se vuoi spostare l'indicatore, puoi modificare questo valore in qualsiasi momento. - Titolo
- Una stringa di testo che viene visualizzata in una finestra informativa quando l'utente tocca l'indicatore. Puoi modificare questo valore in qualsiasi momento.
- Snippet
- Testo aggiuntivo visualizzato sotto il titolo. Puoi modificare questo valore in qualsiasi momento.
- Icona
- Una bitmap visualizzata per l'indicatore. Se l'icona non viene impostata, viene visualizzata un'icona predefinita. Puoi specificare una colorazione alternativa dell'icona predefinita utilizzando
defaultMarker(float)
. - Trascina stato
- Se vuoi consentire all'utente di trascinare l'indicatore, imposta questa proprietà su
true
. Puoi modificare questo valore in qualsiasi momento. Il valore predefinito èfalse
. - Visibilità
- Per impostazione predefinita, l'indicatore è visibile. Per rendere invisibile l'indicatore, imposta questa proprietà su
false
. Puoi modificare questo valore in qualsiasi momento. - Piatto o cartellone
- Se l'indicatore è piatto e appoggiato alla mappa, rimane bloccato durante la rotazione e l'inclinazione della fotocamera, ma mantiene le stesse dimensioni dello zoom della fotocamera, a differenza di un
GroundOverlay
. Se l'indicatore è un cartellone pubblicitario, sarà sempre disegnato rivolto verso la fotocamera e ruoterà e si inclinarà insieme alla fotocamera. Il valore predefinito è un cartellone (false
). - Rotazione
- La rotazione dell'indicatore in gradi in senso orario rispetto al punto di ancoraggio dell'indicatore. L'asse di rotazione è perpendicolare all'indicatore. Una rotazione pari a 0 corrisponde alla posizione predefinita dell'indicatore. Quando l'indicatore è piatto sulla mappa, la posizione predefinita è allineata a nord e la rotazione è tale che l'indicatore rimanga sempre piatto sulla mappa. Quando l'indicatore è un cartellone pubblicitario, la posizione predefinita è rivolta verso l'alto e la rotazione è tale che l'indicatore è sempre rivolto verso la fotocamera. Il valore predefinito è 0.
- zIndex
- Ordine di estrazione dell'indicatore. Gli indicatori sono tracciati in ordine di zIndex, con l'indicatore zIndex più alto disegnato nella parte superiore. Impostando la proprietà zIndex per ogni indicatore, puoi controllare il target dei tocchi che ha maggiori probabilità di essere raggiunto dall'utente. Il valore predefinito è 0.
- Tag
- Un elemento
Object
associato all'indicatore. Ad esempio,Object
può contenere dati relativi a ciò che rappresenta l'indicatore. Questa operazione è più semplice rispetto all'archiviazione di unMap<Marker, Object>
separato. Come ulteriore esempio, puoi associare un IDString
corrispondente all'ID di un set di dati. L'SDK Google Maps for Android non legge né scrive questa proprietà.
I metodi di questa classe devono essere chiamati nel thread dell'interfaccia utente Android. In caso contrario, verrà generato un IllegalStateException
in fase di runtime.
Esempio
GoogleMap map = ... // get a map.
// Add a marker at San Francisco.
Marker marker = map.addMarker(new MarkerOptions()
.position(new LatLng(37.7750, 122.4183))
.title("San Francisco")
.snippet("Population: 776733"));
Guida per gli sviluppatori
Per ulteriori informazioni, leggi la guida per gli sviluppatori sui indicatori.
Riepilogo dei corsi nidificati
@interface | Marker.CollisionBehavior | Indica come viene gestito l'indicatore in caso di collisione con altri indicatori o etichette della mappa base. |
Riepilogo del metodo pubblico
boolean | |
float |
getAlpha()
Restituisce la versione alpha dell'indicatore.
|
Stringa |
getId()
Recupera l'ID di questo indicatore.
|
LatLng |
getPosition()
Restituisce la posizione dell'indicatore.
|
float |
getRotation()
Restituisce la rotazione dell'indicatore.
|
Stringa |
getSnippet()
Consente di acquisire lo snippet dell'indicatore.
|
Oggetto |
getTag()
Ottieni il tag per l'indicatore.
|
Stringa |
getTitle()
Restituisce il titolo dell'indicatore.
|
float |
getZIndex()
Restituisce il valore zIndex dell'indicatore.
|
int |
hashCode()
|
void |
hideInfoWindow()
Nasconde la finestra informativa se viene visualizzata da questo indicatore.
|
boolean |
isDraggable()
Consente di ottenere la trascinabilità dell'indicatore.
|
boolean |
isFlat()
Ottieni l'impostazione flat dell'indicatore.
|
boolean |
isInfoWindowShown()
Indica se la finestra informativa è attualmente visualizzata sopra questo indicatore.
|
boolean |
isVisible()
Restituisce l'impostazione di visibilità di questo indicatore.
|
void |
remove()
Rimuove l'indicatore dalla mappa.
|
void |
setAlpha(alpha in virgola mobile)
Consente di impostare l'alfa (opacità) dell'indicatore.
|
void |
setAnchor(ancoraggio a virgola mobileU, ancoraggio a virgola mobileV)
Imposta il punto di ancoraggio per l'indicatore.
|
void |
setDraggable(booleano trascinabile)
Consente di impostare la trascinabilità dell'indicatore.
|
void |
setFlat(booleano bemolle)
Consente di impostare se questo indicatore deve essere piatto rispetto alla mappa
true o a un cartellone rivolto verso la fotocamera false . |
void | |
void |
setInfoWindowAnchor(ancoraggio mobileU, ancoraggio mobileV)
Specifica il punto dell'immagine dell'indicatore in cui ancorare la finestra informativa quando viene visualizzata.
|
void | |
void |
setRotation(rotazione float)
Imposta la rotazione dell'indicatore in gradi in senso orario rispetto al punto di ancoraggio dell'indicatore.
|
void |
setSnippet(Snippet stringa)
Imposta lo snippet dell'indicatore.
|
void |
setTag(tag oggetto)
Imposta il tag per l'indicatore.
|
void |
setTitle(Titolo stringa)
Imposta il titolo dell'indicatore.
|
void |
setVisible(boolean visibile)
Imposta la visibilità di questo indicatore.
|
void |
setZIndex(zIndex in virgola mobile)
Imposta il valore zIndex dell'indicatore.
|
void |
showInfoWindow()
Mostra la finestra informativa di questo indicatore sulla mappa, se questo indicatore
isVisible() . |
Riepilogo del metodo ereditato
Metodi pubblici
Public booleano uguale a (Object other)
numero in virgola mobile pubblico getAlpha ()
Restituisce la versione alpha dell'indicatore.
Ritorni
- l'alfa dell'indicatore nell'intervallo [0, 1].
Stringa pubblica getId ()
Recupera l'ID di questo indicatore. L'ID sarà univoco tra tutti gli indicatori sulla mappa.
Ritorni
- l'ID di questo indicatore.
pubblica LatLng getPosition ()
Restituisce la posizione dell'indicatore.
Ritorni
- Un oggetto
LatLng
che specifica la posizione corrente dell'indicatore.
numero in virgola mobile pubblico getRotation ()
Restituisce la rotazione dell'indicatore.
Ritorni
- la rotazione dell'indicatore in gradi in senso orario rispetto alla posizione predefinita.
pubblica Stringa getSnippet ()
Consente di acquisire lo snippet dell'indicatore.
Ritorni
- Una stringa contenente lo snippet dell'indicatore.
pubblico Oggetto getTag ()
Ottieni il tag per l'indicatore.
Ritorni
- il tag se un tag è stato impostato con
setTag
;null
se non è stato impostato alcun tag.
Stringa pubblica getTitle ()
Restituisce il titolo dell'indicatore.
Ritorni
- Una stringa contenente il titolo dell'indicatore.
numero in virgola mobile getZIndex ()
Restituisce il valore zIndex dell'indicatore.
Ritorni
- lo zIndex di questo indicatore.
pubblici int hashCode ()
Public void hideInfoWindow ()
Nasconde la finestra informativa se viene visualizzata da questo indicatore.
Questo metodo non ha effetto se l'indicatore non è visibile.
pubblico booleano isDraggable ()
Consente di ottenere la trascinabilità dell'indicatore. Quando un indicatore è trascinabile, l'utente può spostarlo premendo a lungo sull'indicatore.
Ritorni
true
se l'indicatore può essere trascinato; in caso contrario, restituiscefalse
.
pubblico booleano isFlat ()
Ottieni l'impostazione flat dell'indicatore.
Ritorni
true
se l'indicatore è piatto rispetto alla mappa;false
se l'indicatore deve essere rivolto verso la fotocamera.
pubblici booleano isInfoWindowShown ()
Indica se la finestra informativa è attualmente visualizzata sopra questo indicatore. Questo non considera se la finestra informativa è effettivamente visibile sullo schermo.
pubblici booleano isVisible ()
Restituisce l'impostazione di visibilità di questo indicatore. Tieni presente che ciò non indica se l'indicatore si trova all'interno dell'area visibile dello schermo. Indica se l'indicatore verrà disegnato se è contenuto nell'area visibile dello schermo.
Ritorni
- la visibilità di questo indicatore.
Public void remove ()
Rimuove l'indicatore dalla mappa. Dopo la rimozione di un indicatore, il comportamento di tutti i suoi metodi non è definito.
Public void setAlpha (float alpha)
Consente di impostare l'alfa (opacità) dell'indicatore. È un valore compreso tra 0 e 1, dove 0 indica che l'indicatore è completamente trasparente e 1 significa che l'indicatore è completamente opaco.
Parametri
alfa |
---|
Public void setAnchor (float anchorU, float anchorV)
Imposta il punto di ancoraggio per l'indicatore.
L'ancoraggio specifica il punto nell'immagine dell'icona ancorato alla posizione dell'indicatore sulla superficie del pianeta.
Il punto di ancoraggio è specificato nello spazio continuo [0,0, 1,0] x [0,0, 1,0], dove (0, 0) è l'angolo in alto a sinistra dell'immagine e (1, 1) è l'angolo in basso a destra. Il punto di ancoraggio in un'immagine L x A è il punto di griglia discreto più vicino in una griglia (L + 1) x (H + 1), ottenuto scalando l'arrotondamento successivo. Ad esempio, in un'immagine 4 x 2, il punto di ancoraggio (0,7, 0,6) si risolve nel punto della griglia in (3, 1).
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----* *-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----X-----+ (X, Y) = (3, 1) | | | | | | | | | | *-----+-----+-----+-----*
Parametri
anchorU | Coordinata u dell'ancoraggio, sotto forma di rapporto tra la larghezza dell'immagine (nell'intervallo [0, 1]). |
---|---|
anchorV | Coordinata v dell'ancoraggio, come rapporto dell'altezza dell'immagine (nell'intervallo [0, 1]). |
Public void setDraggable (boolean draggable)
Consente di impostare la trascinabilità dell'indicatore. Quando un indicatore è trascinabile, l'utente può spostarlo premendo a lungo sull'indicatore.
Parametri
trascinabile |
---|
Public void setFlat (booleano flat)
Consente di impostare se questo indicatore deve essere piatto rispetto alla mappa true
o a un cartellone rivolto verso la fotocamera false
.
Parametri
fisse |
---|
Public void setIcon (BitmapDescriptor iconDescriptor)
Consente di impostare l'icona dell'indicatore.
Parametri
iconDescriptor | Se null, viene utilizzato l'indicatore predefinito. |
---|
Public void setInfoWindowAnchor (float anchorU, float anchorV)
Specifica il punto dell'immagine dell'indicatore in cui ancorare la finestra informativa quando viene visualizzata. Queste coordinate sono specificate nello stesso sistema di coordinate dell'ancoraggio. Per ulteriori dettagli, visita la pagina setAnchor(float, float)
. L'impostazione predefinita è la parte centrale superiore dell'immagine.
Parametri
anchorU | Coordinata u dell'ancoraggio della finestra informativa, come rapporto della larghezza dell'immagine (nell'intervallo [0, 1]). |
---|---|
anchorV | Coordinata v dell'ancoraggio della finestra informativa, come rapporto dell'altezza dell'immagine (nell'intervallo [0, 1]). |
Public void setPosition (LatLng latlng)
Consente di impostare la posizione dell'indicatore.
Parametri
Latlng |
---|
Public void setRotation (rotazione float)
Imposta la rotazione dell'indicatore in gradi in senso orario rispetto al punto di ancoraggio dell'indicatore. L'asse di rotazione è perpendicolare all'indicatore. Una rotazione pari a 0 corrisponde alla posizione predefinita dell'indicatore.
Parametri
rotazione |
---|
Public void setSnippet (Snippet stringa)
Imposta lo snippet dell'indicatore.
Parametri
snippet | Se null, lo snippet viene cancellato. |
---|
Public void setTag (Tag oggetto)
Imposta il tag per l'indicatore.
Puoi utilizzare questa proprietà per associare un valore Object
arbitrario a questo indicatore. Ad
esempio, Object
può contenere dati relativi a ciò che rappresenta l'indicatore. Questa operazione è più semplice rispetto all'archiviazione di un Map<Marker, Object>
separato. Come ulteriore esempio, puoi associare un
ID String
corrispondente all'ID di un set di dati. L'SDK Google Maps for Android non legge né scrive questa proprietà. È tua responsabilità chiamare setTag(null)
per cancellare il tag quando non ti serve più, al fine di evitare perdite di memoria nella tua app.
Parametri
tag (m.) | Se null, il tag viene cancellato. |
---|
Public void setTitle (Titolo stringa)
Imposta il titolo dell'indicatore.
Parametri
title | Se null, il titolo viene cancellato. |
---|
Public void setVisible (boolean visible)
Imposta la visibilità di questo indicatore. Se impostato su false
e al momento è visualizzata una finestra informativa per questo indicatore, la finestra informativa verrà nascosta.
Parametri
visibile |
---|
Public void setZIndex (zIndex in virgola mobile)
Imposta il valore zIndex dell'indicatore.
Parametri
zIndex |
---|
Public void showInfoWindow ()
Mostra la finestra informativa di questo indicatore sulla mappa, se questo indicatore isVisible()
.
Tiri
IllegalArgumentException | se marker non è su questa mappa
|
---|