Indicatore

classe finale pubblica Marker estende l'oggetto

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 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à.

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
uguale a(Altro oggetto)
Verifica se questo Marker è uguale a un altro.
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
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
setIcon(BitmapDescriptor iconDescriptor)
Imposta l'icona dell'indicatore.
nullo
setInfoWindowAnchor(floating anchorU, fluttua anchorV)
Specifica il punto nell'immagine in cui deve essere ancorata la finestra informativa quando viene visualizzata.
nullo
setPosition(LatLng latlng)
Imposta la posizione dell'indicatore.
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)

Verifica se questo Marker è uguale a un altro.

Parametri
altro un Object.
Restituisce
  • true se entrambi gli oggetti sono lo stesso, ovvero == other.

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

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 setPosition (LatLng latlng)

Imposta la posizione dell'indicatore.

Parametri
Latlng

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