Polígono

Es un polígono en la superficie terrestre. Un polígono puede ser convexo o cóncavo, puede abarcar los 180 y puede tener agujeros 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. Integra no es necesario que los puntos de inicio y finalización coincidan; si no lo hacen, el polígono se cierren automáticamente. Los segmentos de línea se dibujan entre puntos consecutivos en la forma de las dos direcciones (este u oeste).

Orificios

Un agujero es una región dentro del polígono que no se rellena. Un agujero se especifica exactamente de la misma manera que el esquema. Un orificio debe estar completamente contenido dentro del contorno. Múltiples se pueden especificar orificios, sin embargo, no se admiten orificios superpuestos.

Ancho del trazo

Es el ancho del segmento de línea en píxeles de pantalla. El ancho es constante e independiente del nivel de zoom. El valor predeterminado es 10.

Color del trazo

Color de segmento de línea en formato ARGB, el mismo formato que usa Color. El valor predeterminado es el negro (0xff000000).

Tipo de unión con trazo

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

Patrón de trazo

Sólido (predeterminado, representado por null) o una secuencia de objetos PatternItem repetirse 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 el guion longitud en píxeles) y Dot (circular, centrado en el contorno del polígono, diámetro) definida por el ancho del trazo en píxeles).

Color de relleno

Color de relleno en formato ARGB, el mismo formato que usa Color. El el valor predeterminado es transparente (0x00000000). Si no se especifica la geometría del polígono correctamente (consulta la sección anterior sobre contorno y agujeros), entonces 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 elementos Polyline, Circle, GroundOverlay y TileOverlay, 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. El orden de las superposiciones con el mismo valor del í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. Los polígono invisible no se dibuja, pero conserva todas sus 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 lugar de líneas rectas en la proyección de Mercator. Una línea geodésica es la ruta más corta entre dos puntos en la superficie de la Tierra. 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 se configuró como true, tu app recibirá notificaciones para la GoogleMap.OnPolygonClickListener registrada 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.

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 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 documentación para desarrolladores de Formas. .