Círculo

la clase final pública Circle extiende el objeto

Un círculo en la superficie de la Tierra (tapa esférica)

Un círculo tiene las siguientes propiedades.

ayuda
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
El ancho del contorno del círculo en píxeles de la pantalla El ancho es constante e independiente del nivel de zoom de la cámara. El valor predeterminado es 10.
Color del trazo
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án a lo largo del contorno del círculo. Tipos de PatternItem disponibles: Gap (definido por la longitud del espacio en píxeles), Dash (definido por el ancho del trazo y 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 completa 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 con respecto a otras superposiciones (incluidas GroundOverlay, TileOverlay, Polyline y Polygon, pero no Marker). Una superposición con un índice z más grande se dibuja sobre las superposiciones con índices z más pequeños. Para las superposiciones con el mismo índice Z, el orden es arbitrario. El valor predeterminado de zIndex es 0.
Visibilidad
Indica si el círculo es visible o invisible, es decir, si está dibujado en el mapa. Un círculo invisible no se dibuja, pero retiene todas sus otras 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 correspondiente 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 deben llamarse en el subproceso de la IU de Android. De lo contrario, se arrojará una IllegalStateException en 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 puede dibujar el relleno del círculo si abarca el polo norte o sur. Sin embargo, el esquema se dibujará correctamente de todos modos.

Guía para desarrolladores

Para obtener más información, lee la guía para desarrolladores de Formas.

Resumen de métodos públicos

LatLng.
getCenter()
Muestra el centro como LatLng.
int
getFillColor()
Muestra el color de relleno de este círculo.
String
getId()
Obtiene el ID de este círculo.
double
getRadius()
Muestra el radio del círculo en metros.
int
getStrokeColor()
Muestra el color de trazo.
Lista<PatternItem>
getStrokePattern()
Muestra el patrón de trazo del contorno de este círculo.
flotante
getStrokeWidth()
Muestra el ancho del trazo.
Objeto
getTag()
Obtiene la etiqueta para el círculo.
flotante
getZIndex()
Muestra zIndex.
boolean
isClickable()
Obtiene la posibilidad de hacer clic en el círculo.
boolean
esVisible()
Comprueba si el círculo es visible.
void
remove()
Elimina este círculo del mapa.
void
setCenter(centro LatLng)
Establece el centro con un LatLng.
void
setClickable(booleano en el que se puede hacer clic)
Establece la posibilidad de hacer clic en el círculo.
void
setFillColor(color int)
Establece el color de relleno.
void
setRadius(radio doble)
Establece el radio en metros.
void
setStrokeColor(color int)
Establece el color de trazo.
void
setStrokePattern(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 para el círculo.
void
setVisible(booleano visible)
Establece la visibilidad del círculo.
void
setZIndex(zIndex flotante)
Establece zIndex.

Resumen de métodos heredados

Métodos públicos

público LatLng getCenter ()

Muestra el centro como LatLng.

Resultado que se muestra
  • El centro geográfico como LatLng

public int getFillColor ()

Muestra el color de relleno de este círculo.

Resultado que se muestra
  • El color de relleno del círculo en formato ARGB.

public String getId ()

Obtiene el ID de este círculo. El ID será único entre todos los círculos en un mapa.

public double getRadius ()

Muestra el radio del círculo en metros.

Resultado que se muestra
  • El radio en metros.

public int getStrokeColor ()

Muestra el color de trazo.

Resultado que se muestra
  • El color del círculo en formato ARGB.

List público<PatternItem> getStrokePattern ()

Muestra el patrón de trazo del contorno de este círculo.

Resultado que se muestra
  • el patrón de trazo.

public float getStrokeWidth ()

Muestra el ancho del trazo.

Resultado que se muestra
  • Es el ancho en píxeles de la pantalla.

public Object getTag ()

Obtiene la etiqueta para el círculo.

Resultado que se muestra
  • la etiqueta si se configuró una etiqueta con setTag; null si no se configuró ninguna.

flotante público getZIndex ()

Muestra zIndex.

Resultado que se muestra
  • El índice Z de este círculo.

Booleano público isClickable ()

Obtiene la posibilidad de hacer clic en el círculo. Si se puede hacer clic en el círculo, tu app recibirá notificaciones para GoogleMap.OnCircleClickListener cuando el usuario haga clic en el círculo. El objeto de escucha de eventos se registra mediante setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Resultado que se muestra
  • true si se puede hacer clic en el círculo; false si no se puede hacer clic en él.

Booleano público isVisible ()

Comprueba si el círculo es visible.

Resultado que se muestra
  • true si el círculo es visible; false si es invisible

vacío público quitar ()

Elimina este círculo del mapa. Después de quitar un círculo, el comportamiento de todos sus métodos no está definido.

vacío público setCenter (Centro 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

vacío público setClickable (booleano en el que se puede hacer clic)

Establece la posibilidad de hacer clic en el círculo. Si se puede hacer clic en el círculo, tu app recibirá notificaciones para GoogleMap.OnCircleClickListener cuando el usuario haga clic en el círculo. El objeto de escucha de eventos se registra mediante setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Parámetros
se le puede hacer clic Nueva configuración de clic para el círculo.

void 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 dibujará ningún relleno.

Parámetros
color El color en el formato Color

vacío 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

void público setStrokeColor (int color)

Establece el color de trazo.

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

Parámetros
color El color de trazo en formato Color.

void público setStrokePattern (List<PatternItem> pattern)

Establece el patrón de trazo del contorno del círculo. El patrón de trazo predeterminado es sólido y se representa con null.

Parámetros
patrón el patrón de trazo.

vacío público setStrokeWidth (ancho flotante)

Establece el ancho del trazo.

El ancho del trazo es el ancho (en píxeles de la 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

vacío público setTag (etiqueta de objeto)

Establece la etiqueta para el 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 correspondiente 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 fugas de memoria en tu app.

Parámetros
etiqueta de política Si es nulo, la etiqueta se borra.

vacío público setVisible (booleano visible)

Establece la visibilidad del círculo.

Si este círculo no está visible, no se dibujará. Todos los demás estados se conservan. Los círculos son visibles de forma predeterminada.

Parámetros
visible true para hacer visible este círculo; false para hacerlo invisible.

public void setZIndex (float zIndex)

Establece zIndex.

Las superposiciones (como los círculos) con índices zIn más altos se dibujan encima de las que tienen índices más bajos.

Parámetros
Índice Z El valor zIndex.