Un'icona posizionata in un determinato punto sulla superficie della mappa. L'icona di un indicatore è disegnata orientata rispetto allo schermo del dispositivo anziché alla superficie della mappa; ovvero non cambierà necessariamente Orientamento dovuto alla rotazione, all'inclinazione o allo zoom della mappa.
Un indicatore ha le seguenti proprietà:
- Alpha
- Imposta l'opacità dell'indicatore. Il valore predefinito è 1,0.
- Ancoraggio
- Il punto dell'immagine che verrà posizionato nella posizione
LatLng
dell'indicatore. Il valore predefinito è 50% dal lato sinistro e nella parte inferiore dell'immagine. - Posizione
- Il valore
LatLng
per la posizione dell'indicatore sulla mappa. Puoi modificare questo valore in in qualsiasi momento se vuoi spostare l'indicatore. - 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 che viene visualizzata per l'indicatore. Se l'icona non viene impostata, viene applicata un'icona predefinita
visualizzati. Puoi specificare una colorazione alternativa dell'icona predefinita utilizzando
defaultMarker(float)
. - Stato trascinamento
- Se vuoi consentire all'utente di trascinare l'indicatore, imposta questa proprietà su
true
. Tu 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. - Flat o Billboard
- Se l'indicatore è in orizzontale rispetto alla mappa, rimarrà bloccato sulla mappa mentre la fotocamera
ruota e si inclina, ma rimarrà nelle stesse dimensioni dello zoom della fotocamera, a differenza di
GroundOverlay
. Se l'indicatore è un cartellone pubblicitario, sarà sempre disegnato rivolto verso la fotocamera e ruoterà e si inclina con la 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 della rotazione è perpendicolare all'indicatore. Una rotazione pari a 0 corrisponde al valore predefinito posizione dell'indicatore. Quando l'indicatore è piatto sulla mappa, la posizione predefinita è Nord e la rotazione fa sì che l'indicatore rimanga sempre piatto sulla mappa. Quando l'indicatore è un cartellone, la posizione predefinita è rivolta verso l'alto e la rotazione è tale l'indicatore sia sempre rivolto verso la fotocamera. Il valore predefinito è 0.
- zIndex
- L'ordine di disegno per l'indicatore. Gli indicatori sono tracciati in ordine di zIndex, con i indicatore zIndex più alto disegnato sopra. Impostando la proprietà zIndex per ogni indicatore, puoi controllare il target dei tocchi che l'utente ha più probabilità di raggiungere. Il valore predefinito è 0.
- Tag
- Un
Object
associato all'indicatore. Ad esempio,Object
può contenere i dati relativi a ciò che rappresenta l'indicatore. È più semplice che archiviare un fileMap<Marker, Object>
separato. Per fare un altro esempio, puoi associare un IDString
corrispondente all'ID di un set di dati. Google Maps SDK for Android non legge né legge scrive questa proprietà.
I metodi in questa classe devono essere chiamati nel thread della UI di Android. In caso contrario, durante il runtime verrà generato un errore IllegalStateException
.
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 maggiori informazioni, leggi la sezione per gli sviluppatori relativa agli indicatori guida.
Riepilogo della classe nidificata
@interface | Marker.CollisionBehavior | Indica come viene gestito l'indicatore quando è coinvolto in una collisione con altri indicatori o altre basi etichette della mappa. |
Riepilogo del metodo pubblico
booleano | |
numero in virgola mobile |
getAlpha()
Ottiene l'alfa dell'indicatore.
|
Stringa |
getId()
Recupera l'ID di questo indicatore.
|
LatLng |
getPosition()
Restituisce la posizione dell'indicatore.
|
numero in virgola mobile |
getRotation()
Consente di acquisire la rotazione dell'indicatore.
|
Stringa |
getSnippet()
Ottiene lo snippet dell'indicatore.
|
Oggetto |
getTag()
Ottiene il tag per l'indicatore.
|
Stringa |
getTitle()
Ottiene il titolo dell'indicatore.
|
numero in virgola mobile |
getZIndex()
Restituisce il valore zIndex dell'indicatore.
|
int |
hashCode()
|
null |
hideInfoWindow()
Nasconde la finestra informativa se viene visualizzata da questo indicatore.
|
booleano |
isDraggable()
Consente di acquisire la capacità di trascinamento dell'indicatore.
|
booleano |
isFlat()
Consente di acquisire l'impostazione piatta dell'indicatore.
|
booleano |
isInfoWindowShown()
Indica se la finestra informativa è attualmente visualizzata sopra questo indicatore.
|
booleano |
isVisible()
Ottiene l'impostazione di visibilità di questo indicatore.
|
null |
remove()
Rimuove questo indicatore dalla mappa.
|
null |
setAlpha(float alpha)
Imposta l'alfa (opacità) dell'indicatore.
|
null |
setAnchor(ancoraggio mobileU, ancoraggio in virgola mobileV)
Imposta il punto di ancoraggio per l'indicatore.
|
null |
setDraggable(boolean draggable)
Imposta la possibilità di trascinamento dell'indicatore.
|
null |
setFlat(booleano flat)
Consente di impostare se questo indicatore deve essere allineato alla mappa
true o a un cartellone rivolto verso la
fotocamera false . |
null | |
null |
setInfoWindowAnchor(float anchorU, float anchorV)
Specifica il punto nell'immagine dell'indicatore in cui ancorare la finestra informativa quando si trova
visualizzati.
|
null | |
null |
setRotation(rotazione mobile)
Imposta la rotazione dell'indicatore in gradi in senso orario intorno al punto di ancoraggio dell'indicatore.
|
null |
setSnippet(Snippet stringa)
Imposta lo snippet dell'indicatore.
|
null |
setTag(tag oggetto)
Imposta il tag per l'indicatore.
|
null |
setTitle(Titolo stringa)
Imposta il titolo dell'indicatore.
|
null |
setVisible(boolean visible)
Consente di impostare la visibilità di questo indicatore.
|
null |
setZIndex(float zIndex)
Imposta il valore zIndex dell'indicatore.
|
null |
showInfoWindow()
Mostra la finestra informativa di questo indicatore sulla mappa, se questo indicatore è
isVisible() . |
Riepilogo del metodo ereditato
Metodi pubblici
pubblica booleano . uguale a (altro oggetto)
pubblica in virgola mobile . getAlpha ()
Ottiene l'alfa dell'indicatore.
Resi
- l'alfa dell'indicatore nell'intervallo [0, 1].
pubblica Stringa . getId ()
Recupera l'ID di questo indicatore. L'ID sarà univoco tra tutti gli indicatori su una mappa.
Resi
- l'ID di questo indicatore.
pubblica LatLng getPosition ()
Restituisce la posizione dell'indicatore.
Resi
- Un oggetto
LatLng
che specifica la posizione corrente dell'indicatore.
pubblica in virgola mobile . getRotation ()
Consente di acquisire la rotazione dell'indicatore.
Resi
- la rotazione dell'indicatore in gradi in senso orario rispetto alla posizione predefinita.
pubblica Stringa . getSnippet ()
Ottiene lo snippet dell'indicatore.
Resi
- Una stringa contenente lo snippet dell'indicatore.
pubblica Oggetto . getTag ()
Ottiene il tag per l'indicatore.
Resi
- il tag, se è stato impostato con
setTag
;null
se non è stato impostato alcun tag.
pubblica Stringa . getTitle ()
Ottiene il titolo dell'indicatore.
Resi
- Una stringa contenente il titolo dell'indicatore.
pubblica in virgola mobile . getZIndex ()
Restituisce il valore zIndex dell'indicatore.
Resi
- lo zIndex di questo indicatore.
pubblica int . hashCode ()
pubblica null . hideInfoWindow ()
Nasconde la finestra informativa se viene visualizzata da questo indicatore.
Questo metodo non ha alcun effetto se questo indicatore non è visibile.
pubblica booleano . isDraggable ()
Consente di acquisire la capacità di trascinamento dell'indicatore. Quando un indicatore è trascinabile, può essere spostato dall'utente pressione prolungata sull'indicatore.
Resi
true
se l'indicatore è trascinabile; altrimenti restituiscefalse
.
pubblica booleano . isFlat ()
Consente di acquisire l'impostazione piatta dell'indicatore.
Resi
true
se l'indicatore è in linea con la mappa;false
se l'indicatore deve rivolto verso la fotocamera.
pubblica booleano . isInfoWindowShown ()
Indica se la finestra informativa è attualmente visualizzata sopra questo indicatore. Ciò non considera la visibilità della finestra informativa sullo schermo.
pubblica booleano . isVisible ()
Ottiene l'impostazione di visibilità di questo indicatore. Tieni presente che ciò non indica se l'indicatore si trova nell'area visibile dello schermo. Indica se l'indicatore verrà disegnato contenuto nell'area visibile dello schermo.
Resi
- la visibilità di questo indicatore.
pubblica null . rimuovi ()
Rimuove questo indicatore dalla mappa. Dopo che un indicatore è stato rimosso, il comportamento di tutti i suoi non è definito.
pubblica null . setAlpha (alpha virgola mobile)
Imposta l'alfa (opacità) dell'indicatore. Il valore va da 0 a 1, dove 0 indica l'indicatore è completamente trasparente e 1 significa che l'indicatore è completamente opaco.
Parametri
alfa |
---|
pubblica null . 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 terrestre.
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 di L x A è il punto della griglia discreto più vicino in un intervallo (W + 1) x Griglia (H + 1), ottenuta scalando l'arrotondamento seguito. 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, come rapporto della larghezza dell'immagine (nell'intervallo [0, 1]). |
---|---|
anchorV | Coordinata v dell'ancoraggio, come rapporto tra l'altezza dell'immagine (nell'intervallo [0, 1]). |
pubblica null . setDraggable (booleano trascinabile)
Imposta la possibilità di trascinamento dell'indicatore. Quando un indicatore è trascinabile, può essere spostato dall'utente pressione prolungata sull'indicatore.
Parametri
trascinabile |
---|
pubblica null . setFlat (booleano piatto)
Consente di impostare se questo indicatore deve essere allineato alla mappa true
o a un cartellone rivolto verso la
fotocamera false
.
Parametri
bemolle |
---|
pubblica null . setIcon (BitmapDescriptor iconDescriptor)
Consente di impostare l'icona dell'indicatore.
Parametri
iconDescriptor | Se nullo, viene utilizzato l'indicatore predefinito. |
---|
pubblica null . setInfoWindowAnchor (float anchorU, float anchorV)
Specifica il punto nell'immagine dell'indicatore in cui ancorare la finestra informativa quando si trova
visualizzati. Questo valore viene specificato nello stesso sistema di coordinate dell'ancoraggio. Per maggiori dettagli, visita la pagina setAnchor(float, float)
. Il valore predefinito è la parte superiore centrale dell'immagine.
Parametri
anchorU | Coordinata u dell'ancoraggio della finestra informativa, come rapporto tra la larghezza dell'immagine (nel intervallo [0, 1]). |
---|---|
anchorV | Coordinata v dell'ancoraggio della finestra informativa, come rapporto tra l'altezza dell'immagine (nel intervallo [0, 1]). |
pubblica null . setPosition (LatLng latlng)
Consente di impostare la posizione dell'indicatore.
Parametri
Latlng |
---|
pubblica null . setRotation (rotazione mobile)
Imposta la rotazione dell'indicatore in gradi in senso orario intorno al punto di ancoraggio dell'indicatore. L'asse della rotazione è perpendicolare all'indicatore. Una rotazione pari a 0 corrisponde alla posizione predefinita dell'indicatore.
Parametri
rotazione |
---|
pubblica null . setSnippet (Snippet stringa)
Imposta lo snippet dell'indicatore.
Parametri
snippet | Se nullo, lo snippet viene cancellato. |
---|
pubblica null . setTag (tag oggetto)
Imposta il tag per l'indicatore.
Puoi utilizzare questa proprietà per associare un Object
arbitrario a questo indicatore. Per
Ad esempio, Object
può contenere dati relativi a ciò che rappresenta l'indicatore. È più facile
rispetto all'archiviazione di un elemento Map<Marker, Object>
separato. Per fare un altro esempio, puoi associare una
ID String
corrispondente all'ID di un set di dati. né Google Maps SDK per Android né
legge né scrive questa proprietà. È tua responsabilità chiamare setTag(null)
per risolvere
quando non ti serve più, per evitare fughe di memoria nella tua app.
Parametri
tag | se nullo, il tag viene cancellato. |
---|
pubblica null . setTitle (Titolo stringa)
Imposta il titolo dell'indicatore.
Parametri
titolo | Se nullo, il titolo viene cancellato. |
---|
pubblica null . setVisible (booleano visibile)
Imposta la visibilità di questo indicatore. Se impostato su false
e al momento è visualizzata una finestra informativa
mostrato per questo indicatore, la finestra informativa viene nascosta.
Parametri
visibile |
---|
pubblica null . setZIndex (zIndex in virgola mobile)
Imposta il valore zIndex dell'indicatore.
Parametri
zIndex |
---|
pubblica null . showInfoWindow ()
Mostra la finestra informativa di questo indicatore sulla mappa, se questo indicatore è isVisible()
.
Lanci
IllegalArgumentException | se marker non è su questa mappa
|
---|