Polígono

Un polígono sobre la superficie terrestre. Un polígono puede ser convexo o cóncavo, puede abarcar el meridiano de 180° y tener orificios sin rellenar. Tiene las siguientes propiedades:

Contorno

El contorno se especifica mediante una lista de vértices en el sentido de las manecillas del reloj o en el sentido contrario. No es necesario que los puntos de inicio y de destino coincidan. De lo contrario, el polígono se cerrará automáticamente. Los segmentos de línea se trazan entre puntos consecutivos en el más corto de las dos direcciones (este u oeste).

Orificios

Un agujero es una región dentro del polígono que no está rellenada. Los orificios se especifican de la misma manera que el contorno. Debe haber un orificio dentro del contorno. Se pueden especificar varios agujeros; sin embargo, no se admiten orificios superpuestos.

Ancho del trazo

Ancho del segmento de línea 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 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á al unir segmentos de líneas adyacentes en todos los vértices del contorno del polígono. Consulta JointType para ver los tipos de unión admitidos. El valor predeterminado es DEFAULT.

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 polígono. 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 polígono, diámetro definido por el ancho del trazo en píxeles).

Color de relleno

Rellena el color en formato ARGB, el mismo formato que usa Color. El valor predeterminado es transparente (0x00000000). Si no se especifica correctamente la geometría del polígono (consulta la sección Contorno y Agujeros 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, incluidos los objetos Polyline, Circle, GroundOverlay y TileOverlay, pero no Marker. Una superposición con un índice z más grande se dibuja sobre aquellas 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 dibujó en el mapa. Un polígono invisible no se dibuja, pero conserva todas las demás propiedades. El valor predeterminado es true, es decir, visible.

Estado geodésico

Indica si los segmentos del polígono se deben dibujar como líneas geodésicas, en oposición a las líneas rectas en la proyección Mercator. Una línea geodésica es la ruta más corta entre dos puntos de la superficie terrestre. La curva geodésica se construye suponiendo que la Tierra es una esfera.

Posibilidad de hacer clics

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 el GoogleMap.OnPolygonClickListener registrado a través de setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Etiqueta

Es un Object asociado con el polígono. Por ejemplo, el objeto 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 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 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, consulta la guía para desarrolladores sobre Formas.