Polilínea

Una polilínea es una lista de puntos, en la que los segmentos de línea se dibujan entre puntos consecutivos. Una polilínea tiene las siguientes propiedades:

Puntos

Los vértices de la línea. Los segmentos de línea se dibujan entre puntos consecutivos. Una polilínea no está cerrada de forma predeterminada. Para formar una polilínea cerrada, los puntos de inicio y finalización deben ser los mismos.

Ancho

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

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

Límite de inicio/finalización

Define la forma que se usará al principio o al final de una polilínea. Tipos de límites admitidos: ButtCap, SquareCap, RoundCap (aplicable para un patrón de trazo sólido) y CustomCap (aplicable para cualquier patrón de trazo). Predeterminado para el inicio y el final: ButtCap.

Tipo de unión

El tipo de unión define la forma que se usará cuando se unan segmentos de línea adyacentes en todos los vértices de la polilínea, excepto los vértices de inicio y finalización. 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 en la línea Tipos de PatternItem disponibles: Gap (definido por la longitud del espacio en píxeles), Dash (definido por el ancho de la línea y longitud del guion en píxeles) y Dot (circular, centrado en la línea, diámetro definido por el ancho de la línea en píxeles).

Índice Z

Es el orden en el que se dibuja esta superposición con respecto a otras superposiciones (incluidas GroundOverlay, TileOverlay, Circle 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 la polilínea es visible o invisible, es decir, si se dibuja en el mapa. Una polilínea invisible no se dibuja, pero retiene todas las demás propiedades. El valor predeterminado es true, es decir, visible.

Estado geodésico

Indica si los segmentos de la polilínea 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 la polilínea, 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.OnPolylineClickListener registradas a través de setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Etiqueta

Es un objeto Object asociado con la polilínea. Por ejemplo, Object puede contener datos sobre lo que representa la polilínea. Esto es más fácil que almacenar un Map<Polyline, 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.

Intervalos

Define los intervalos con diferentes estilos utilizados para renderizar esta polilínea. Puedes usar esta propiedad para crear una polilínea con diferentes StrokeStyle en distintos segmentos de la polilínea.

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 thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));
 

Guía para desarrolladores

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