.
Es un círculo sobre la superficie terrestre (gorro esférico).
Un círculo tiene las siguientes propiedades.
- Centro
- El centro del círculo se especifica como
LatLng
. - Radio
- El radio del círculo, especificado en metros. Debe ser cero o mayor.
- Ancho del trazo
- Es el ancho del contorno del círculo en píxeles de pantalla. El ancho es constante y no depende del nivel de zoom de la cámara. El valor predeterminado es 10.
- Color del trazo
- Es el color del contorno del círculo en formato ARGB, el mismo formato que usa
Color
. El valor predeterminado es el negro (0xff000000
). - Patrón de trazo
- Sólido (predeterminado, representado por
null
) o una secuencia de objetosPatternItem
que se repetirá a lo largo del contorno del círculo. Tipos dePatternItem
disponibles:Gap
(definido por la longitud de espacio en píxeles),Dash
(definido por el ancho del trazo y la longitud del guion en píxeles) yDot
(circular, centrado en el contorno del círculo, diámetro definido por el ancho del trazo en píxeles). - Color de relleno
- El color del círculo tiene el formato ARGB, el mismo formato que usa
Color
. El valor predeterminado es transparente (0x00000000
). - Índice Z
- Es el orden en el que se dibuja esta superposición de mosaicos con respecto a otras superposiciones (incluidos los objetos
GroundOverlay
,TileOverlay
,Polyline
yPolygon
, pero no losMarker
). Una superposición con un índice z más grande se dibuja sobre aquellas con índices z más pequeños. Para las superposiciones con el mismo índice Z, el orden es arbitrario. El valor predeterminado del zIndex es 0. - Visibilidad
- Indica si el círculo es visible o invisible, es decir, si se dibujó en el mapa. Un círculo invisible no se dibuja, pero conserva todas las demás propiedades. El valor predeterminado es
true
, es decir, visible. - Etiqueta
- Es un
Object
asociado con el círculo. Por ejemplo,Object
puede contener datos sobre lo que representa el círculo. Esto es más fácil que almacenar unMap<Circle, Object>
separado. Como otro ejemplo, puedes asociar un ID deString
que corresponde al ID de un conjunto de datos. El SDK de Google Maps para Android no lee ni escribe esta propiedad.
Los métodos de esta clase se deben llamar en el subproceso de IU de Android. De lo contrario, se arrojará una IllegalStateException
durante el tiempo de ejecución.
Ejemplo
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));
Ten en cuenta que el procesador de mapas actual no podrá dibujar el relleno del círculo si este abarca el polo norte o sur. Sin embargo, el contorno se dibujará correctamente.
Guía para desarrolladores
Para obtener más información, consulta la guía para desarrolladores sobre Formas.
Resumen de métodos públicos
LatLng | |
int |
getFillColor().
Muestra el color de relleno de este círculo.
|
Cadena |
getId()
Obtiene el ID de este círculo.
|
doble |
getRadius()
Muestra el radio del círculo en metros.
|
int |
getStrokeColor().
Muestra el color del trazo.
|
List<PatternItem> |
getStrokePattern().
Muestra el patrón de trazo del contorno de este círculo.
|
float |
getStrokeWidth().
Muestra el ancho del trazo.
|
Objeto |
getTag()
Obtiene la etiqueta del círculo.
|
float |
getZIndex()
Muestra el zIndex.
|
boolean |
isClickable()
Obtiene la posibilidad de hacer clics del círculo.
|
boolean |
isVisible()
Comprueba si el círculo es visible.
|
void |
remove()
Elimina este círculo del mapa.
|
void | |
void |
setClickable(booleano en el que se puede hacer clic)
Establece la posibilidad de hacer clics en el círculo.
|
void |
setFillColor(color total)
Establece el color de relleno.
|
void |
setRadius(radio doble)
Establece el radio en metros.
|
void |
setStrokeColor(color total)
Establece el color del trazo.
|
void |
setStrokePattern(patrón de lista<PatternItem>)
Establece el patrón de trazo del contorno del círculo.
|
void |
setStrokeWidth(ancho flotante)
Establece el ancho del trazo.
|
void |
setTag(etiqueta de objeto)
Establece la etiqueta del círculo.
|
void |
setVisible(booleano visible)
Establece la visibilidad del círculo.
|
void |
setZIndex(zIndex flotante)
Establece el zIndex.
|
Resumen de métodos heredados
Métodos públicos
público LatLng getCenter ()
public int getFillColor ()
Muestra el color de relleno de este círculo.
Devuelve
- Es el color de relleno del círculo en formato ARGB.
String pública getId ()
Obtiene el ID de este círculo. El ID será único entre todos los círculos de un mapa.
public double getRadius ()
Muestra el radio del círculo en metros.
Devuelve
- El radio en metros.
public int getStrokeColor ()
Muestra el color del trazo.
Devuelve
- El color del círculo en formato ARGB
public List<PatternItem> getStrokePattern ()
Muestra el patrón de trazo del contorno de este círculo.
Devuelve
- patrón de trazo.
número de punto flotante público getStrokeWidth ()
Muestra el ancho del trazo.
Devuelve
- Es el ancho en píxeles de la pantalla.
objeto público getTag ()
Obtiene la etiqueta del círculo.
Devuelve
- la etiqueta si se configuró con
setTag
;null
si no se estableció ninguna
public float getZIndex ()
Muestra el zIndex.
Devuelve
- El zIndex de este círculo.
público booleano isClickable ()
Obtiene la posibilidad de hacer clics del círculo. Si se puede hacer clic en el círculo, tu app recibirá notificaciones al GoogleMap.OnCircleClickListener
cuando el usuario haga clic en él.
El objeto de escucha de eventos se registra a través de setOnCircleClickListener(GoogleMap.OnCircleClickListener)
.
Devuelve
true
si se puede hacer clic en el círculo;false
si no se puede hacer clic en él.
público booleano isVisible ()
Comprueba si el círculo es visible.
Devuelve
true
si el círculo es visible;false
si es invisible.
public void remove ()
Elimina este círculo del mapa. Una vez que se quita un círculo, el comportamiento de todos sus métodos queda indefinido.
público público setCenter (Centro de LatLng)
público público setClickable (booleano en el que se puede hacer clic)
Establece la posibilidad de hacer clics en el círculo. Si se puede hacer clic en el círculo, tu app recibirá notificaciones al GoogleMap.OnCircleClickListener
cuando el usuario haga clic en él.
El objeto de escucha de eventos se registra a través de setOnCircleClickListener(GoogleMap.OnCircleClickListener)
.
Parámetros
se le puede hacer clic | Nueva configuración de posibilidad de hacer clics para el círculo. |
---|
público público setFillColor (int color)
público público setRadius (radio doble)
Establece el radio en metros.
El radio debe ser cero o mayor.
Parámetros
radio | El radio en metros |
---|
Arroja
IllegalArgumentException | si el radio es negativo |
---|
público público setStrokeColor (int color)
público público setStrokePattern (List<PatternItem>)
Establece el patrón de trazo del contorno del círculo. El patrón de trazo predeterminado es sólido, representado por null
.
Parámetros
patrón | patrón de trazo. |
---|
público void setStrokeWidth (ancho de número de punto flotante)
Establece el ancho del trazo.
El ancho del trazo es el ancho (en píxeles de pantalla) del contorno del círculo. Debe ser cero o mayor. Si es cero, no se dibuja ningún contorno. El valor predeterminado es 10.
Parámetros
ancho | Es el ancho del trazo en píxeles de la pantalla. |
---|
Arroja
IllegalArgumentException | si el ancho es negativo |
---|
public void setTag (etiqueta de objeto)
Establece la etiqueta del círculo.
Puedes usar esta propiedad para asociar un Object
arbitrario con este círculo. Por ejemplo, Object
puede contener datos sobre lo que representa el círculo. Esto es más fácil que almacenar un Map<Circle, Object>
separado. Como otro ejemplo, puedes asociar un ID de String
que corresponde al ID de un conjunto de datos. El SDK de Google Maps para Android no lee ni escribe esta propiedad. Es tu responsabilidad llamar a setTag(null)
para borrar la etiqueta cuando ya no la necesites y evitar pérdidas de memoria en tu app.
Parámetros
etiqueta de política | si es nulo, se borra la etiqueta. |
---|
público público setVisible (boolean visible)
Establece la visibilidad del círculo.
Si este círculo no se ve, no se dibujará. El resto del estado se conserva. Los círculos son visibles de forma predeterminada.
Parámetros
visible | true para que este círculo sea visible; false para que sea invisible.
|
---|
público público setZIndex (float zIndex)
Establece el zIndex.
Las superposiciones (como los círculos) con índices z más altos se dibujan encima de las que tienen índices más bajos.
Parámetros
zIndex | Es el valor zIndex. |
---|