Un cerchio sulla superficie terrestre (cappello sferico).
Un cerchio ha le seguenti proprietà.
- Al centro
- Il centro del cerchio indica
LatLng
. - Radius
- Il raggio del cerchio, specificato in metri. Deve essere zero o superiore.
- Larghezza tratto
- La larghezza del contorno del cerchio in pixel dello schermo. La larghezza è costante e indipendente dal livello di zoom della videocamera. Il valore predefinito è 10.
- Colore tratto
- Il colore del cerchio nel contorno ARGB, lo stesso formato utilizzato da
Color
. Il valore predefinito è nero (0xff000000
). - Tracciato
- Solido (predefinito, rappresentato da
null
) o una sequenza di oggettiPatternItem
da ripetere lungo il contorno del cerchio. Tipi diPatternItem
disponibili:Gap
(definiti dalla lunghezza del divario in pixel),Dash
(definiti dalla larghezza del tratto e la lunghezza del trattino in pixel) eDot
(circa, centrati sul contorno del cerchio, diametro definito dalla larghezza del tratto in pixel). - Colore riempimento
- Il colore del cerchio viene utilizzato nel formato ARGB, lo stesso formato utilizzato da
Color
. Il valore predefinito è trasparente (0x00000000
). - Z-index
- L'ordine in cui viene disegnato questo overlay del riquadro rispetto agli altri overlay (inclusi
GroundOverlay
,TileOverlay
,Polyline
ePolygon
, ma non perMarker
). Un overlay con uno z-index più grande viene disegnato su overlay con z-index più piccoli. L'ordine degli overlay 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 tracciato, ma conserva tutte le altre proprietà. Il valore predefinito è
true
, ovvero visibile. - Tag
- Un
Object
associato al cerchio. Ad esempio,Object
può contenere dati relativi al significato del cerchio. Questa operazione è più semplice rispetto all'archiviazione di unMap<Circle, 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 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 l'attuale renderer della mappa non è in grado di tracciare il riempimento del cerchio se il cerchio comprende il Polo Nord o Sud. Tuttavia, il contorno verrà comunque disegnato correttamente.
Guida per gli sviluppatori
Per ulteriori informazioni, leggi la guida per gli sviluppatori di Shapes.
Riepilogo del metodo pubblico
LatLng | |
int |
getFillColor()
Restituisce il colore di riempimento di questo cerchio.
|
Stringa |
getId()
Recupera l'ID di questo cerchio.
|
double |
getRadius()
Restituisce il raggio del cerchio, in metri.
|
int |
getStrokeColor()
Restituisce il colore del tratto.
|
List<PatternItem> |
getStrokePattern()
Restituisce lo schema tratto del contorno di questo cerchio.
|
numero in virgola mobile |
getStrokeWidth()
Restituisce la larghezza del tratto.
|
Oggetto |
getTag
Recupera il tag per il cerchio.
|
numero in virgola mobile |
getZIndex()
Restituisce zIndex.
|
boolean |
isClickable()
Visualizza la cliccabilità del cerchio.
|
boolean |
isVisible()
Verifica se il cerchio è visibile.
|
nullo |
rimuovi()
Rimuove questo cerchio dalla mappa.
|
nullo | |
nullo |
setClickable(booleano cliccabile)
Imposta la cliccabilità del cerchio.
|
nullo |
setFillColor(colore colore)
Imposta il colore di riempimento.
|
nullo |
setRadius(doppio raggio)
Imposta il raggio in metri.
|
nullo |
setStrokeColor(colore colore)
Imposta il colore del tratto.
|
nullo | |
nullo |
setStrokeWidth(larghezza del floating)
Imposta la larghezza del tratto.
|
nullo |
setTag(Tag oggetto)
Imposta il tag per il cerchio.
|
nullo |
setVisible(booleano visibile)
Imposta la visibilità del cerchio.
|
nullo |
setZIndex(zindex mobile)
Imposta zIndex.
|
Riepilogo del metodo ereditato
Metodi pubblici
pubblico LatLng getCenter ()
public int getFillColor ()
Restituisce il colore di riempimento di questo cerchio.
Restituisce
- Il colore di riempimento del cerchio in formato ARGB.
pubblica Stringa getId ()
Recupera l'ID di questo cerchio. L'ID sarà univoco tra tutti i cerchi di una mappa.
pubblico doppio getRadius ()
Restituisce il raggio del cerchio, in metri.
Restituisce
- Il raggio in metri.
public int getStrokeColor ()
Restituisce il colore del tratto.
Restituisce
- Il colore del cerchio in formato ARGB.
public List<PatternItem> getStrokePattern ()
Restituisce lo schema tratto del contorno di questo cerchio.
Restituisce
- l'andamento del tratto.
floating pubblico getStrokeWidth ()
Restituisce la larghezza del tratto.
Restituisce
- La larghezza in pixel dello schermo.
pubblico Oggetto getTag ()
Recupera il tag per il cerchio.
Restituisce
- il tag se è stato impostato con
setTag
;null
se non è stato impostato alcun tag.
floating pubblico getZIndex ()
Restituisce zIndex.
Restituisce
- Lo z-index di questo cerchio.
pubblico booleano isClickable ()
Visualizza la cliccabilità del cerchio. Se è possibile fare clic sul cerchio, l'app riceverà notifiche al GoogleMap.OnCircleClickListener
quando l'utente fa clic sul cerchio.
Il listener di eventi è registrato tramite setOnCircleClickListener(GoogleMap.OnCircleClickListener)
.
Restituisce
true
se il cerchio è selezionabile;false
se non è cliccabile.
pubblico booleano isVisible ()
Verifica se il cerchio è visibile.
Restituisce
true
se il cerchio è visibile;false
se è invisibile.
pubblica void rimuovi ()
Rimuove questo cerchio dalla mappa. In seguito alla rimozione di un cerchio, il comportamento di tutti i suoi metodi è indefinito.
pubblico void setCenter (centro LatLng)
pubblico void setClickable (booleano cliccabile)
Imposta la cliccabilità del cerchio. Se è possibile fare clic sul cerchio, l'app riceverà notifiche al 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 (colore di colore)
pubblica void setRadius (doppio raggio)
Imposta il raggio in metri.
Il raggio deve essere pari a zero o superiore.
Parametri
raggio | Il raggio, espresso in metri. |
---|
Genera
Eccezione Argomento illegale | se il raggio è negativo |
---|
pubblico void setStrokeColor (colore int)
public void setStrokePattern (List<PatternItem> pattern)
Imposta il pattern del tratto del contorno del cerchio. Il pattern tratto predefinito è solido, rappresentato da null
.
Parametri
pattern | l'andamento del tratto. |
---|
public void setStrokeWidth (larghezza di virgola mobile)
Imposta la larghezza del tratto.
Lo spessore del tratto è la larghezza (in pixel dello schermo) del contorno del cerchio. Deve essere zero o maggiore. Se è zero, non viene tracciata alcuna struttura. Il valore predefinito è 10.
Parametri
width | Lo spessore del tratto, in pixel dello schermo. |
---|
Genera
Eccezione Argomento illegale | se la larghezza è negativa |
---|
pubblica void setTag (Tag oggetto)
Imposta il tag per il cerchio.
Puoi utilizzare questa proprietà per associare un elemento Object
arbitrario a questo cerchio. Ad esempio, Object
può contenere dati relativi a ciò che rappresenta il cerchio. Questa operazione è più semplice
che l'archiviazione di un Map<Circle, 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. |
---|
pubblica void setVisible (booleano visibile)
Imposta la visibilità del cerchio.
Se questo cerchio non è visibile, non sarà disegnato. Tutto il resto viene conservato. I cerchi sono visibili per impostazione predefinita.
Parametri
visibile | true per rendere visibile questa cerchia; false per renderla invisibile.
|
---|
pubblico void setZIndex (zindex mobile)
Imposta zIndex.
Gli overlay (ad esempio cerchi) con zIndice più alti vengono tracciati sopra quelli con indici inferiori.
Parametri
z-index | Il valore zIndex. |
---|