Un'icona posizionata in un punto specifico sulla superficie della mappa. L'icona di un indicatore è disegnata orientata sullo schermo del dispositivo anziché sulla superficie della mappa, ad esempio non cambia 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. L'impostazione predefinita è il 50% a sinistra dell'immagine e in fondo all'immagine. - Posizione
- Il valore
LatLng
della posizione dell'indicatore sulla mappa. Puoi modificare questo valore in qualsiasi momento se vuoi spostare l'indicatore. - Qualifica
- 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)
. - Stato di trascinamento
- 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 sulla mappa, quest'ultimo rimarrà fermo sulla mappa quando la fotocamera ruota e si inclina, ma rimarrà della stessa dimensione dello zoom, a differenza di un
GroundOverlay
. Se l'indicatore è un cartellone pubblicitario, sarà sempre disegnato di fronte alla fotocamera e ruotato e inclinato con la fotocamera. L'impostazione predefinita è un cartellone pubblicitario (false
) - Rotazione
- La rotazione dell'indicatore in gradi in senso orario intorno al punto di ancoraggio dell'indicatore. L'asse di rotazione è perpendicolare all'indicatore. Una rotazione di 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 è rivolta verso la fotocamera. Il valore predefinito è 0.
- z-index
- L'ordine in cui è stato tracciato l'indicatore. Gli indicatori vengono tracciati nell'ordine dello zindex, con l'indicatore zIndex più alto riportato in alto. Impostando la proprietà zIndex per ogni indicatore, puoi controllare quale target dei tocchi ha più probabilità di raggiungere il tuo utente. Il valore predefinito è 0.
- Tag
- Un
Object
associato all'indicatore. Ad esempio,Object
può contenere dati su 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. Google Maps SDK for Android non legge né scrive questa proprietà.
I metodi in questa classe devono essere chiamati nel thread dell'interfaccia utente di Android. In caso contrario, verrà lanciato un elemento IllegalStateException
durante il 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 maggiori informazioni, leggi la guida per gli sviluppatori Markers.
Riepilogo delle classi nidificate
@interfaccia | Marker.CollisionComportamento | Indica come viene trattato l'indicatore in caso di incidente con altri indicatori o con etichette delle mappe di base. |
Riepilogo del metodo pubblico
boolean | |
numero in virgola mobile |
getAlpha()
Visualizza la versione alpha dell'indicatore.
|
Stringa |
getId()
Recupera l'ID di questo indicatore.
|
LatLng |
getPosition()
Restituisce la posizione dell'indicatore.
|
numero in virgola mobile |
getRotation()
Visualizza la rotazione dell'indicatore.
|
Stringa |
getSnippet()
Visualizza lo snippet dell'indicatore.
|
Oggetto |
getTag
Recupera il tag per l'indicatore.
|
Stringa |
getTitle()
Visualizza il titolo dell'indicatore.
|
numero in virgola mobile |
getZIndex()
Restituisce lo z-index dell'indicatore.
|
int |
hashCode()
|
nullo |
hideInfoWindow()
Nasconde la finestra informativa se viene mostrata da questo indicatore.
|
boolean |
is Draggable()
Consente di trascinare l'indicatore.
|
boolean |
isFlat()
Visualizza l'impostazione piatta dell'indicatore.
|
boolean |
isInfoWindowShow()
Restituisce se la finestra informativa è attualmente visualizzata sopra questo indicatore.
|
boolean |
isVisible()
Visualizza l'impostazione di visibilità di questo indicatore.
|
nullo |
rimuovi()
Rimuove questo indicatore dalla mappa.
|
nullo |
setAlpha(alpha mobile)
Imposta l'alfa (opacità) dell'indicatore.
|
nullo |
setAnchor(anchor anchor fluttuante, anchor fluttuante V)
Imposta il punto di ancoraggio per l'indicatore.
|
nullo |
setTrascinagable(trascinabile booleano)
Imposta la trascinamento dell'indicatore.
|
nullo |
setFlat(piatta booleana)
Consente di impostare se questo indicatore deve essere piatto rispetto alla mappa
true o un cartellone pubblicitario rivolto verso la fotocamera false . |
nullo | |
nullo |
setInfoWindowAnchor(floating anchorU, fluttua anchorV)
Specifica il punto nell'immagine in cui deve essere ancorata la finestra informativa
quando viene visualizzata.
|
nullo | |
nullo |
setRotation(rotazione mobile)
Imposta la rotazione dell'indicatore in gradi in senso orario rispetto al punto di ancoraggio dell'indicatore.
|
nullo |
setSnippet(Snippet stringa)
Imposta lo snippet dell'indicatore.
|
nullo |
setTag(Tag oggetto)
Imposta il tag per l'indicatore.
|
nullo |
setTitle(String title)
Imposta il titolo dell'indicatore.
|
nullo |
setVisible(booleano visibile)
Imposta la visibilità di questo indicatore.
|
nullo |
setZIndex(zindex mobile)
Imposta lo z-index dell'indicatore.
|
nullo |
showInfoWindow()
Mostra la finestra informativa di questo indicatore sulla mappa, se questo indicatore
isVisible() . |
Riepilogo del metodo ereditato
Metodi pubblici
pubblico booleano uguale a (Altro oggetto)
floating pubblico getAlpha ()
Visualizza la versione alpha dell'indicatore.
Restituisce
- l'alpha 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.
Restituisce
- questo indicatore.
pubblica LatLng getPosition ()
Restituisce la posizione dell'indicatore.
Restituisce
- Un oggetto
LatLng
che specifica la posizione corrente dell'indicatore.
floating pubblico getRotation ()
Visualizza la rotazione dell'indicatore.
Restituisce
- la rotazione dell'indicatore in gradi in senso orario rispetto alla posizione predefinita.
pubblica Stringa getSnippet ()
Visualizza lo snippet dell'indicatore.
Restituisce
- Una stringa contenente lo snippet dell'indicatore.
pubblico Oggetto getTag ()
Recupera il tag per l'indicatore.
Restituisce
- il tag se è stato impostato con
setTag
;null
se non è stato impostato alcun tag.
pubblica Stringa getTitle ()
Visualizza il titolo dell'indicatore.
Restituisce
- Una stringa contenente il titolo dell'indicatore.
floating pubblico getZIndex ()
Restituisce lo z-index dell'indicatore.
Restituisce
- questo zIndex questo indicatore.
public int hashCode ()
pubblica void hideInfoWindow ()
Nasconde la finestra informativa se viene mostrata da questo indicatore.
Questo metodo non ha effetto se questo indicatore non è visibile.
pubblico booleano is Draggable ()
Consente di trascinare l'indicatore. Quando un indicatore è trascinabile, può essere spostato dall'utente premendo a lungo l'indicatore.
Restituisce
true
se l'indicatore è trascinabile; in caso contrario, restituiscefalse
.
pubblico booleano isFlat ()
Visualizza l'impostazione piatta dell'indicatore.
Restituisce
true
se l'indicatore è piatto sulla mappa;false
se l'indicatore deve essere rivolto verso la fotocamera.
pubblico booleano isInfoWindowShow ()
Restituisce se la finestra informativa è attualmente visualizzata sopra questo indicatore. Non valuta se la finestra informativa è effettivamente visibile o meno sullo schermo.
pubblico booleano isVisible ()
Visualizza 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 è disegnato se è contenuto nell'area visibile dello schermo.
Restituisce
- la visibilità di questo indicatore.
pubblica void rimuovi ()
Rimuove questo indicatore dalla mappa. Dopo la rimozione di un indicatore, il comportamento di tutti i suoi metodi è indefinito.
pubblico void setAlpha (versione alfa in virgola mobile)
Imposta l'alfa (opacità) dell'indicatore. È un valore compreso tra 0 e 1, dove 0 indica che l'indicatore è completamente trasparente e 1 indica che l'indicatore è completamente opaco.
Parametri
alfa |
---|
public void setAnchor (floating anchorU, fluttua anchorV)
Imposta il punto di ancoraggio per l'indicatore.
L'ancoraggio specifica il punto nell'immagine dell'icona che è 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 W x H è il punto griglia più vicino in una griglia (W + 1) x (H + 1), ottenuto scalando il arrotondamento. Ad esempio, in un'immagine 4 x 2, il punto di ancoraggio (0,7, 0,6) si risolve nel punto della griglia (3, 1).
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----* *-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----X-----+ (X, Y) = (3, 1) | | | | | | | | | | *-----+-----+-----+-----*
Parametri
ancoraggioU | coordinata u dell'ancoraggio, come rapporto tra la larghezza dell'immagine (nell'intervallo [0, 1]). |
---|---|
ancoraggioV | coordinata v dell'ancoraggio, come rapporto dell'altezza dell'immagine (nell'intervallo [0, 1]). |
pubblica void setTrascinagable (trascinabile booleano)
Imposta la trascinamento dell'indicatore. Quando un indicatore è trascinabile, può essere spostato dall'utente premendo a lungo l'indicatore.
Parametri
trascinabile |
---|
pubblico void setFlat (piatta booleana)
Consente di impostare se questo indicatore deve essere piatto rispetto alla mappa true
o un cartellone pubblicitario rivolto verso la fotocamera false
.
Parametri
fisse |
---|
pubblico void setIcon (BitmapDescriptor iconDescriptor)
Imposta l'icona dell'indicatore.
Parametri
iconDescriptor | se null, viene utilizzato l'indicatore predefinito. |
---|
public void setInfoWindowAnchor ( floating anchorU, fluttua anchorV)
Specifica il punto nell'immagine in cui deve essere ancorata la finestra informativa
quando viene visualizzata. Questo valore è specificato nello stesso sistema di coordinate dell'ancoraggio. Per ulteriori dettagli, consulta setAnchor(float, float)
. L'impostazione predefinita è la parte superiore centrale dell'immagine.
Parametri
ancoraggioU | coordinata u dell'ancoraggio della finestra informativa, in rapporto alla larghezza dell'immagine (nell'intervallo [0, 1]). |
---|---|
ancoraggioV | coordinata v dell'ancoraggio alla finestra informativa, come rapporto dell'altezza dell'immagine (nell'intervallo [0, 1]). |
pubblica void setRotation (rotazione mobile)
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 di 0 corrisponde alla posizione predefinita dell'indicatore.
Parametri
rotazione |
---|
pubblico void setSnippet (snippet stringa)
Imposta lo snippet dell'indicatore.
Parametri
snippet | se il valore è null, lo snippet viene cancellato. |
---|
pubblica void setTag (Tag oggetto)
Imposta il tag per l'indicatore.
Puoi utilizzare questa proprietà per associare un Object
arbitrario a questo indicatore. Ad esempio, Object
può contenere dati su ciò che rappresenta l'indicatore. Questa operazione è più semplice
che l'archiviazione di un Map<Marker, Object>
separato. Come ulteriore esempio, puoi associare un ID String
corrispondente all'ID di un set di dati. Google Maps SDK for Android non legge né scrive questa proprietà. È tua responsabilità chiamare il numero setTag(null)
per cancellare
il tag quando non ti serve più, per evitare perdite di memoria nella tua app.
Parametri
tag (m.) | se il valore è null, il tag viene cancellato. |
---|
public void setTitle (String title)
Imposta il titolo dell'indicatore.
Parametri
title | se null, il titolo viene cancellato. |
---|
pubblica void setVisible (booleano visibile)
Imposta la visibilità di questo indicatore. Se è impostata su false
e al momento è visualizzata una finestra informativa per questo indicatore, questa finestra verrà nascosta.
Parametri
visibile |
---|
pubblico void setZIndex (zindex mobile)
Imposta lo z-index dell'indicatore.
Parametri
z-index |
---|
pubblica void showInfoWindow ()
Mostra la finestra informativa di questo indicatore sulla mappa, se questo indicatore isVisible()
.
Genera
Eccezione Argomento illegale | se marker non è su questa mappa
|
---|