Se usó la API de Cloud Translation para traducir esta página.

Círculo

La clase final pública Circle extiende Object
.

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 objetos PatternItem que se repetirá a lo largo del contorno del círculo. Tipos de PatternItem 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) y Dot (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 y Polygon, pero no los Marker). 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 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.

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	getCenter() Muestra el centro como un `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	setCenter(centro de LatLng) Establece el centro con un `LatLng`.
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

Desde la clase java.lang.Object

boolean	es igual a(objeto arg0)
clase final<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
Cadena	toString()
final void	wait(long arg0, int arg1)
final void	wait(argumento largo)
final void	wait()

Métodos públicos

público LatLng getCenter ()

Muestra el centro como un LatLng.

Devuelve

El centro geográfico como LatLng.

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)

Establece el centro con un LatLng.

El centro no debe ser nulo, ya que no hay un valor predeterminado.

Parámetros

centro	El centro geográfico del círculo, especificado como `LatLng`.

Arroja

NullPointerException	si el centro es nulo

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)

Establece el color de relleno.

El color de relleno es el color dentro del círculo, en el formato de número entero especificado por Color. Si se usa TRANSPARENTE, no se dibuja ningún relleno.

Parámetros

color [color]	Es el color en formato `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)

Establece el color del trazo.

El color del trazo es el del contorno de este círculo, en el formato de número entero que se especifica en Color. Si se usa TRANSPARENTE, no se dibuja ningún contorno.

Parámetros

color [color]	El color de trazo en formato `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.