Polígono

Un polígono sobre la superficie de la Tierra. Un polígono puede ser convexo o cóncavo, puede abarcar los 180 meridianos y puede tener agujeros que no están rellenos. Tiene las siguientes propiedades:

Descripción

El esquema se especifica en una lista de vértices en sentido horario o antihorario. No es necesario que coincidan los puntos de inicio y finalización; si no lo hacen, el polígono se cerrará automáticamente. Los segmentos de línea se dibujan entre puntos consecutivos en las dos direcciones más cortas (este u oeste).

Orificios

Un orificio es una región dentro del polígono que no está llena. Un agujero se especifica de la misma manera que el contorno. Un orificio debe estar completamente contenido dentro del contorno. Se pueden especificar varios orificios, pero no se admiten los que se superponen.

Ancho del trazo

Ancho de segmento de línea en píxeles de 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 segmento de línea en formato ARGB, el mismo formato que usa Color. El valor predeterminado es el negro (0xff000000).

Tipo de unión de trazo

El tipo de unión define la forma que se usará para unir segmentos de líneas adyacentes en todos los vértices del contorno del polígono. Consulta JointType para conocer los tipos de unión compatibles. El valor predeterminado es DEFAULT.

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 polígono Tipos de PatternItem disponibles: Gap (definido por la longitud del intervalo 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 polígono, diámetro definido por el ancho del trazo en píxeles).

Color de relleno

Color de relleno en formato ARGB, el mismo formato que usa Color El valor predeterminado es transparente (0x00000000). Si la geometría del polígono no se especifica correctamente (consulta los contornos y orificios más arriba), no se dibujará ningún relleno.

Índice Z

Es el orden en el que se dibuja este polígono con respecto a otras superposiciones, incluidas Polyline, Circle, GroundOverlay y TileOverlay, 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. El orden de las superposiciones con el mismo valor de índice z es arbitrario. El valor predeterminado es 0.

Visibilidad

Indica si el polígono es visible o invisible, es decir, si se dibuja en el mapa. Un polígono invisible no se dibuja, pero retiene todas sus otras propiedades. El valor predeterminado es true, es decir, visible.

Estado geodésico

Indica si los segmentos del polígono deben dibujarse como geodésicos, y no en las líneas rectas en la proyección de Mercator. La geodésica es la ruta más corta entre dos puntos de la superficie de la Tierra. La curva geodésica se construye bajo la suposición de que la Tierra es una esfera.

Hacer clic

Si deseas controlar los eventos que se activan cuando el usuario hace clic en el polígono, establece esta propiedad en true. Puedes cambiar este valor en cualquier momento. El valor predeterminado es false. Si esta propiedad se configura como true, tu app recibirá notificaciones para GoogleMap.OnPolygonClickListener registradas a través de setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Etiqueta

Es un objeto Object asociado con el polígono. Por ejemplo, Object puede contener datos sobre lo que representa el polígono. Esto es más fácil que almacenar un Map<Polygon, 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 triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

Guía para desarrolladores

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