Indicatore

lezione finale pubblica Indicatore estende l'oggetto

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 file Map<Marker, Object> separato. Per fare un altro esempio, puoi associare un ID String 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
uguale a(altro oggetto)
Verifica se questo valore di Marker è uguale a un altro.
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
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
setIcon(BitmapDescriptor iconDescriptor)
Consente di impostare l'icona dell'indicatore.
null
setInfoWindowAnchor(float anchorU, float anchorV)
Specifica il punto nell'immagine dell'indicatore in cui ancorare la finestra informativa quando si trova visualizzati.
null
setPosition(LatLng latlng)
Consente di impostare la posizione dell'indicatore.
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)

Verifica se questo valore di Marker è uguale a un altro.

Parametri
altro Object.
Resi
  • true se entrambi gli oggetti sono lo stesso oggetto, ovvero questo == altro.

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 restituisce false.

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