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 diPatternItem
oggetti da ripetere lungo il contorno del cerchio. Tipi diPatternItem
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) eDot
(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
ePolygon
ma nonMarker
). 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 unMap<Circle, Object>
separato. Come ulteriore esempio, puoi associare un IDString
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 | |
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 | |
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 | |
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 ()
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)
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)
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)
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. |
---|