A cerchio

pubblica final class Circle estende Object

Un cerchio sulla superficie terrestre (cappello sferico).

Un cerchio ha le seguenti proprietà.

Centro
Il centro della cerchia è specificato come LatLng.
Radius
Il raggio del cerchio, specificato in metri. Deve essere zero o un numero maggiore.
Larghezza tratto
La larghezza del contorno del cerchio in pixel dello schermo. La larghezza è costante e indipendente dal livello di zoom della fotocamera. Il valore predefinito è 10.
Colore tratto
Il colore del contorno del cerchio in formato ARGB, lo stesso formato utilizzato da Color. Il valore predefinito è nero (0xff000000).
Sequenza del tratto
Solido (predefinito, rappresentato da null) o una sequenza di PatternItem oggetti da ripetere lungo il contorno del cerchio. Tipi di PatternItem disponibili: Gap (definito in base alla lunghezza dell'intervallo in pixel), Dash (definito in base allo spessore del tratto e alla lunghezza del trattino in pixel) e Dot (circolare, centrato sul contorno del cerchio, diametro definito dallo spessore del tratto in pixel).
Colore riempimento
Il colore del cerchio si riempie nel formato ARGB, lo stesso formato utilizzato da Color. Il valore predefinito è trasparente (0x00000000).
Z-index
L'ordine in cui l'overlay di riquadro viene disegnato rispetto agli altri overlay (inclusi GroundOverlay, TileOverlay, Polyline e Polygon ma non Marker). Un overlay con uno z-index più grande viene disegnato sopra gli overlay con indici z più piccoli. L'ordine delle sovrapposizioni con lo stesso z-index è arbitrario. Il valore predefinito di zIndex è 0.
Visibilità
Indica se il cerchio è visibile o invisibile, ovvero se è disegnato sulla mappa. Un cerchio invisibile non viene disegnato, ma conserva tutte le altre proprietà. Il valore predefinito è true, ovvero visibile.
Tag
Un elemento Object associato alla cerchia. Ad esempio, Object può contenere dati su ciò che rappresenta il cerchio. Questa operazione è più semplice rispetto all'archiviazione di un Map<Circle, 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 circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

Tieni presente che il renderer corrente della mappa non è in grado di tracciare il riempimento del cerchio se il cerchio comprende il polo nord o il polo sud. Tuttavia, il contorno verrà comunque tracciato correttamente.

Guida per gli sviluppatori

Per maggiori informazioni, leggi la guida per gli sviluppatori di Forme.

Riepilogo del metodo pubblico

LatLng
getCenter()
Restituisce il centro come LatLng.
int
getFillColor()
Restituisce il colore di riempimento di questa cerchia.
Stringa
getId()
Recupera l'ID di questa cerchia.
double
getRadius()
Restituisce il raggio del cerchio in metri.
int
getStrokeColor()
Restituisce il colore del tratto.
List<PatternItem>
getStrokePattern()
Restituisce lo schema del tratto del contorno di questo cerchio.
float
getStrokeWidth()
Restituisce lo spessore del tratto.
Oggetto
getTag()
Recupera il tag per la cerchia.
float
getZIndex()
Restituisce zIndex.
boolean
isClickable()
Consente di ottenere la cliccabilità del cerchio.
boolean
isVisible()
Verifica se il cerchio è visibile.
void
remove()
Rimuove il cerchio dalla mappa.
void
setCenter(LatLng center)
Imposta il centro utilizzando un LatLng.
void
setClickable(cliccabile booleano)
Imposta la cliccabilità del cerchio.
void
setFillColor(colore interno)
Imposta il colore di riempimento.
void
setRadius(raggio doppio)
Consente di impostare il raggio in metri.
void
setStrokeColor(colore interno)
Imposta il colore del tratto.
void
setStrokePattern(Pattern List<PatternItem>)
Imposta lo schema del tratto del contorno del cerchio.
void
setStrokeWidth(larghezza del virgola mobile)
Imposta lo spessore del tratto.
void
setTag(tag oggetto)
Imposta il tag per il cerchio.
void
setVisible(boolean visibile)
Imposta la visibilità del cerchio.
void
setZIndex(zIndex in virgola mobile)
Imposta il valore zIndex.

Riepilogo del metodo ereditato

Metodi pubblici

pubblica LatLng getCenter ()

Restituisce il centro come LatLng.

Ritorni
  • Il centro geografico come LatLng.

Public int getFillColor ()

Restituisce il colore di riempimento di questa cerchia.

Ritorni
  • Il colore di riempimento del cerchio in formato ARGB.

Stringa pubblica getId ()

Recupera l'ID di questa cerchia. L'ID sarà univoco tra tutte le cerchie sulla mappa.

pubblica double getRadius ()

Restituisce il raggio del cerchio in metri.

Ritorni
  • Il raggio in metri.

pubblico int getStrokeColor ()

Restituisce il colore del tratto.

Ritorni
  • Il colore del cerchio in formato ARGB.

Public List<PatternItem> getStrokePattern ()

Restituisce lo schema del tratto del contorno di questo cerchio.

Ritorni
  • lo schema del tratto.

numero in virgola mobile pubblico getStrokeWidth ()

Restituisce lo spessore del tratto.

Ritorni
  • La larghezza in pixel dello schermo.

pubblico Oggetto getTag ()

Recupera il tag per la cerchia.

Ritorni
  • il tag se un tag è stato impostato con setTag; null se non è stato impostato alcun tag.

numero in virgola mobile getZIndex ()

Restituisce zIndex.

Ritorni
  • Il valore zIndex di questa cerchia.

pubblico booleano isClickable ()

Consente di ottenere la cliccabilità del cerchio. Se il cerchio è cliccabile, l'app riceverà notifiche a GoogleMap.OnCircleClickListener quando l'utente fa clic sul cerchio. Il listener di eventi è registrato tramite setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Ritorni
  • true se il cerchio è cliccabile; false se non è cliccabile.

pubblici booleano isVisible ()

Verifica se il cerchio è visibile.

Ritorni
  • true se il cerchio è visibile; false se è invisibile.

Public void remove ()

Rimuove il cerchio dalla mappa. Dopo che una cerchia è stata rimossa, il comportamento di tutti i suoi metodi non è definito.

Public void setCenter (LatLng center)

Imposta il centro utilizzando un LatLng.

Il centro non deve essere nullo, in quanto non esiste un valore predefinito.

Parametri
centrale Il centro geografico del cerchio, specificato come LatLng.
Tiri
NullPointerException se il centro è null

Public void setClickable (booleano cliccabile)

Imposta la cliccabilità del cerchio. Se il cerchio è cliccabile, l'app riceverà notifiche a GoogleMap.OnCircleClickListener quando l'utente fa clic sul cerchio. Il listener di eventi è registrato tramite setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Parametri
cliccabile Nuova impostazione di cliccabilità per il cerchio.

Public void setFillColor (int color)

Imposta il colore di riempimento.

Il colore di riempimento è il colore all'interno del cerchio, nel formato numero intero specificato da Color. Se viene utilizzata l'opzione TRASPARENTE, non viene tracciato alcun riempimento.

Parametri
colore Il colore nel formato Color.

Public void setRadius (doppio raggio)

Consente di impostare il raggio in metri.

Il raggio deve essere zero o maggiore.

Parametri
raggio Il raggio, in metri.
Tiri
IllegalArgumentException se il raggio è negativo

Public void setStrokeColor (int color)

Imposta il colore del tratto.

Il colore del tratto è il colore del contorno di questo cerchio, nel formato numero intero specificato da Color. Se viene utilizzata l'opzione TRASPARENTE, non viene tracciato alcun contorno.

Parametri
colore Il colore del tratto nel formato Color.

Public void setStrokePattern (Pattern List<PatternItem>)

Imposta lo schema del tratto del contorno del cerchio. Il pattern del tratto predefinito è continuo, rappresentato da null.

Parametri
pattern lo schema del tratto.

Public void setStrokeWidth (larghezza virgola mobile)

Imposta lo spessore del tratto.

Lo spessore del tratto è la larghezza (in pixel dello schermo) del contorno del cerchio. Deve essere zero o maggiore. Se il valore è zero, non viene tracciato alcun contorno. Il valore predefinito è 10.

Parametri
width Lo spessore del tratto, in pixel dello schermo.
Tiri
IllegalArgumentException se la larghezza è negativa

Public void setTag (Tag oggetto)

Imposta il tag per il cerchio.

Puoi utilizzare questa proprietà per associare un valore Object arbitrario a questa cerchia. Ad esempio, Object può contenere dati relativi a ciò che rappresenta il cerchio. Questa operazione è più semplice rispetto all'archiviazione di un Map<Circle, 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 setVisible (boolean visible)

Imposta la visibilità del cerchio.

Se il cerchio non è visibile non verrà disegnato. Tutti gli altri stati vengono mantenuti. Le cerchie sono visibili per impostazione predefinita.

Parametri
visibile true per rendere visibile questo cerchio; false per renderlo invisibile.

Public void setZIndex (zIndex in virgola mobile)

Imposta il valore zIndex.

Le sovrapposizioni (come i cerchi) con indici z più alti vengono disegnate sopra quelle con indici più bassi.

Parametri
zIndex Il valore zIndex.