A cerchio

lezione finale pubblica Cerchia estende l'oggetto

Un cerchio sulla superficie terrestre (cappello sferico).

Un cerchio ha le seguenti proprietà.

Al centro
Il centro del cerchio è specificato come LatLng.
Radius
Il raggio del cerchio specificato in metri. Deve essere pari a zero o maggiore.
Larghezza tratto
La larghezza del contorno del cerchio in pixel sullo schermo. La larghezza è costante e indipendente del livello di zoom della videocamera. 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 tratto
Solido (predefinito, rappresentato da null) o una sequenza di PatternItem oggetti da ripetere lungo il contorno del cerchio. Tipi di PatternItem disponibili: Gap (definita dalla lunghezza intervallo in pixel), Dash (definita da larghezza del tratto e lunghezza del tratto in pixel) e Dot (circolare, centrato sul contorno del cerchio, diametro definito spessore del tratto in pixel).
Colore riempimento
Il colore del cerchio nel formato ARGB, lo stesso formato utilizzato da Color. Il valore predefinito è trasparente (0x00000000).
.
Z-index
L'ordine in cui viene disegnato l'overlay dei riquadri rispetto agli altri overlay (inclusi GroundOverlay, TileOverlay s, Polyline e Polygon s ma non Marker). Un overlay con uno z-index più grande viene disegnato sopra gli overlay con dimensioni indici z. 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 disegnato, ma conserva tutte le altre proprietà. L'impostazione predefinita è true, ovvero visibile.
Tag
Un Object associato alla cerchia. Ad esempio, Object può contenere i dati circa ciò che rappresenta il cerchio. È più semplice che archiviare un file Map<Circle, Object> separato. Per fare un altro esempio, puoi associare un ID String corrispondente all'ID di un set di dati. Google Maps SDK for Android non legge né legge scrive questa proprietà.

I metodi in questa classe devono essere chiamati nel thread della UI di Android. In caso contrario, durante il runtime verrà generato un errore IllegalStateException.

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 della mappa corrente non è in grado di disegnare il riempimento del cerchio se il cerchio comprende il Polo Nord o il Polo Sud. Tuttavia, il contorno continuerà a essere tracciato in modo corretto.

Guida per gli sviluppatori

Per ulteriori informazioni, consulta lo sviluppatore Shapes guida.

Riepilogo del metodo pubblico

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

Riepilogo del metodo ereditato

Metodi pubblici

pubblica LatLng getCenter ()

Restituisce il centro come LatLng.

Resi
  • Il centro geografico come LatLng.

pubblica int . getFillColor ()

Restituisce il colore di riempimento di questo cerchio.

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

pubblica Stringa . getId ()

Ottiene l'ID di questa cerchia. L'ID sarà univoco tra tutti i cerchi su una mappa.

pubblica doppio . getRadius ()

Restituisce il raggio del cerchio, in metri.

Resi
  • Il raggio in metri.

pubblica int . getStrokeColor ()

Restituisce il colore del tratto.

Resi
  • Il colore del cerchio in formato ARGB.

pubblica Elenco<PatternItem> getStrokePattern ()

Restituisce il pattern del tratto del contorno di questo cerchio.

Resi
  • lo schema del tratto.

pubblica in virgola mobile . getStrokeWidth ()

Restituisce lo spessore del tratto.

Resi
  • La larghezza in pixel dello schermo.

pubblica Oggetto . getTag ()

Ottiene il tag per il cerchio.

Resi
  • il tag, se è stato impostato con setTag; null se non è stato impostato alcun tag.

pubblica in virgola mobile . getZIndex ()

Restituisce il valore zIndex.

Resi
  • Lo zIndex di questo cerchio.

pubblica booleano . isClickable ()

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

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

pubblica booleano . isVisible ()

Controlla se il cerchio è visibile.

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

pubblica null . rimuovi ()

Rimuove il cerchio dalla mappa. Quando un cerchio è stato rimosso, il comportamento di tutte le sue non è definito.

pubblica null . setCenter (LatLng centro)

Imposta il centro utilizzando un valore LatLng.

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

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

pubblica null . setClickable (booleano selezionabile)

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

Parametri
selezionabile Nuova impostazione di cliccabilità per la cerchia.

pubblica null . setFillColor (colore int)

Imposta il colore di riempimento.

Il colore di riempimento è il colore all'interno del cerchio, nel formato intero specificato da Color. Se si utilizza TRANSPARENT, non viene tracciato alcun riempimento.

Parametri
colore Il colore nel formato Color.

pubblica null . setRadius (raggio doppio)

Imposta il raggio in metri.

Il raggio deve essere pari a zero o superiore.

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

pubblica null . setStrokeColor (colore int)

Imposta il colore del tratto.

Il colore del tratto è il colore del contorno di questo cerchio, nel formato intero specificato da Color. Se viene utilizzato TRANSPARENT, non viene tracciato alcun contorno.

Parametri
colore Il colore del tratto nel formato Color.

pubblica null . setStrokePattern (pattern List<PatternItem>)

Imposta il pattern del tratto del contorno del cerchio. Il pattern del tratto predefinito è in tinta unita, rappresentato da null.

Parametri
pattern lo schema del tratto.

pubblica null . setStrokeWidth (larghezza in 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 maggiori. Se è pari a zero, non viene tracciato alcun contorno. Il valore predefinito è 10.

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

pubblica null . setTag (tag oggetto)

Imposta il tag per il cerchio.

Puoi utilizzare questa proprietà per associare un Object arbitrario a questa cerchia. Per Ad esempio, Object può contenere dati relativi a ciò che rappresenta il cerchio. È più facile rispetto all'archiviazione di un elemento Map<Circle, Object> separato. Per fare un altro esempio, puoi associare una ID String corrispondente all'ID di un set di dati. né Google Maps SDK per Android né legge né scrive questa proprietà. È tua responsabilità chiamare setTag(null) per risolvere quando non ti serve più, per evitare fughe di memoria nella tua app.

Parametri
tag se nullo, il tag viene cancellato.

pubblica null . setVisible (booleano visibile)

Consente di impostare la visibilità del cerchio.

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

Parametri
visibile true per rendere visibile questa cerchia; false per renderlo invisibile.

pubblica null . setZIndex (zIndex in virgola mobile)

Imposta il valore zIndex.

Gli overlay (come i cerchi) con indici z più elevati vengono tracciati sopra quelli con indici più bassi.

Parametri
zIndex Il valore zIndex.