Círculo

Es un círculo en la superficie de la Tierra (captura esférica).

Un círculo tiene las siguientes propiedades.

Centro

El centro del círculo se especifica como LatLng.

Radio

Es 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 independiente y constante 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 se repita a lo largo del contorno del círculo. Tipos de PatternItem disponibles: Gap (definida por la longitud del intervalo en píxeles), Dash (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 ancho de trazo en píxeles).

Color de relleno

Es el color del relleno del círculo en 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 respecto de otras superposiciones (incluidas las GroundOverlay, TileOverlay, Polyline y Polygon, pero no Marker). Una superposición con un índice z mayor se dibuja sobre las que tienen un índice z más pequeño índices z. Para las superposiciones con el mismo índice Z, el orden es arbitrario. El valor predeterminado zIndex es 0.

Visibilidad

Indica si el círculo es visible o invisible, es decir, si se dibujó en el mapa. Los no se dibuja un círculo invisible, pero conserva todas sus 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 correspondiente al ID de un conjunto de datos. El SDK de Google Maps para Android no lee ni escribe esta propiedad.

Se debe llamar a los métodos de esta clase 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 puede dibujar el relleno de los círculos si el elemento abarca el Polo Norte o el Polo Sur. Sin embargo, el contorno aún se dibujará correctamente.

Guía para desarrolladores

Para obtener más información, consulta la documentación para desarrolladores de Formas. .