Indicatore

classe pubblica finale Marker estende Object

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

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
uguale a(oggetto altro)
Verifica se questo Marker è uguale a un altro.
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
setIcon(BitmapDescriptor iconDescriptor)
Consente di impostare l'icona dell'indicatore.
void
setInfoWindowAnchor(ancoraggio mobileU, ancoraggio mobileV)
Specifica il punto dell'immagine dell'indicatore in cui ancorare la finestra informativa quando viene visualizzata.
void
setPosition(LatLng latlng)
Consente di impostare la posizione dell'indicatore.
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)

Verifica se questo Marker è uguale a un altro.

Parametri
altro un Object.
Ritorni
  • true se entrambi gli oggetti sono lo stesso oggetto, ovvero questo == 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, restituisce false.

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