A cerchio

classi finali pubbliche Circle estende l'oggetto

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 oggetti PatternItem da ripetere lungo il contorno del cerchio. Tipi di PatternItem disponibili: Gap (definiti dalla lunghezza del divario in pixel), Dash (definiti dalla larghezza del tratto e la lunghezza del trattino in pixel) e Dot (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 e Polygon, ma non per Marker). 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 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à.

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
getCenterdi
Restituisce il centro come 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
setCenter(centro LatLng)
Imposta il centro utilizzando un LatLng.
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
setStrokePattern(List<PatternItem> pattern)
Imposta il pattern del tratto del contorno del cerchio.
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 ()

Restituisce il centro come LatLng.

Restituisce
  • Il centro geografico come LatLng.

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)

Imposta il centro utilizzando un LatLng.

Il centro non deve essere nullo, perché non esiste un valore predefinito.

Parametri
al centro Il centro geografico del cerchio, specificato come LatLng.
Genera
Eccezione PointPointer se il centro è null

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)

Imposta il colore di riempimento.

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

Parametri
colore Il colore nel formato Color.

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)

Imposta il colore del tratto.

Il colore del tratto è il colore del contorno di questo cerchio, nel formato intero specificato da Color. Se si utilizza TRASPARENTE, non verrà tracciata alcuna struttura.

Parametri
colore Il colore del tratto nel formato Color.

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.