Polilínea

clase final pública Polyline extiende el objeto

Una polilínea es una lista de puntos en la que los segmentos de línea se dibujan entre puntos consecutivos. R 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 es no se cierra de forma predeterminada. Para formar una polilínea cerrada, los puntos de inicio y finalización deben ser la misma.
Ancho
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
Color de segmento de línea en formato ARGB, el mismo formato que usa Color. El valor predeterminado es el negro (0xff000000).
Límite de inicio y finalización
Define la forma que se debe usar al principio o al final de una polilínea. Tipos de límites admitidos: ButtCap, SquareCap, RoundCap (aplicable para patrones de trazo sólido) y CustomCap (aplicable para cualquier patrón de trazo). Valor predeterminado tanto para el inicio como para el final: ButtCap
Tipo de unión
El tipo de unión define la forma que se usará para unir segmentos de líneas adyacentes. vértices de la polilínea, excepto los vértices de inicio y fin Consulta JointType para 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 se repita a lo largo de la línea. Tipos de PatternItem disponibles: Gap (definido por longitud de separación en píxeles), Dash (definido por el ancho de línea y la longitud de guion en píxeles) y Dot (circular, centrado en la línea, diámetro definido por el ancho de línea en píxeles).
Índice Z
Es el orden en el que se dibuja esta superposición de mosaicos respecto de otras superposiciones (incluidas las GroundOverlay, TileOverlay, Circle y Polygon, pero no Markers). 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 la polilínea es visible o invisible, es decir, si se dibuja en el mapa. Los polilínea 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 de la polilínea 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 la polilínea, establece esta propiedad de la siguiente manera: 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.OnPolylineClickListener registrada 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 los distintos estilos usados para renderizar esta polilínea. Puedes usar esta para crear una polilínea con diferentes StrokeStyle en distintos segmentos de la polilínea.

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

Resumen de métodos públicos

boolean
es igual a(Otro objeto)
Comprueba si este Polyline es igual a otro.
int
getColor()
Obtiene el color de esta polilínea.
Límite
getEndCap()
Obtiene el tope en el vértice final de esta polilínea.
String
getId()
Obtiene el ID de esta polilínea.
int
getJointType()
Obtiene el tipo de unión usado en todos los vértices de la polilínea, excepto los vértices de inicio y final.
Lista<PatternItem>
getPattern()
Obtiene el patrón de trazo de esta polilínea.
Lista<LatLng>
getPoints()
Devuelve una instantánea de los vértices de esta polilínea en este momento .
Límite
getStartCap()
Obtiene el tope en el vértice de inicio de esta polilínea.
Objeto
getTag()
Obtiene la etiqueta de la polilínea.
float
getWidth()
Obtiene el ancho de esta polilínea.
float
getZIndex()
Obtiene el zIndex de esta polilínea.
int
boolean
isClickable()
Obtiene la posibilidad de hacer clics de la polilínea.
boolean
isGeodesic()
Obtiene si cada segmento de la línea se dibuja como una línea geodésica o no.
boolean
isVisible()
Obtiene la visibilidad de esta polilínea.
void
remove()
Elimina esta polilínea del mapa.
void
setClickable(booleano en el que se puede hacer clic)
Establece la posibilidad de hacer clics de la polilínea.
void
setColor(int color)
Establece el color de esta polilínea.
void
setEndCap(Cap endCap)
Establece el tope en el vértice final de esta polilínea.
void
setGeodesic(boolean geodesic)
Establece si cada segmento de la línea se dibuja como una línea geodésica o no.
void
setJointType(int joinType)
Fija el tipo de unión para todos los vértices de la polilínea, excepto los vértices de inicio y final.
void
setPattern(patrón de lista<PatternItem>)
Establece el patrón de trazo de la polilínea.
void
setPoints(Lista<LatLng> puntos)
Establece los puntos de esta polilínea.
void
setSpans(List<StyleSpan> intervalos)
Establece los intervalos de la polilínea.
void
setStartCap(Cap startCap)
Establece el tope en el vértice de inicio de esta polilínea.
void
setTag(etiqueta de objeto)
Establece la etiqueta de la polilínea.
void
setVisible(boolean visible)
Establece la visibilidad de esta polilínea.
void
setWidth(ancho de número de punto flotante)
Establece el ancho de esta polilínea.
void
setZIndex(Índice z de número de punto flotante)
Establece el zIndex de esta polilínea.

Resumen de métodos heredados

Métodos públicos

público booleano es igual a (Otro objeto)

Comprueba si este Polyline es igual a otro.

Parámetros
otro un objeto Object.
Muestra
  • true si ambos objetos son el mismo objeto, es decir, this == other.

público número entero getColor ()

Obtiene el color de esta polilínea.

Muestra
  • el color en formato ARGB.

público Límite . getEndCap ()

Obtiene el tope en el vértice final de esta polilínea.

Muestra
  • el tipo de end cap.

público Cadena getId ()

Obtiene el ID de esta polilínea. El ID será único entre todas las polilíneas de un mapa.

Muestra
  • el ID de esta polilínea.

público número entero getJointType ()

Obtiene el tipo de unión usado en todos los vértices de la polilínea, excepto los vértices de inicio y final. Consulta JointType para los valores posibles.

Muestra
  • el tipo de unión.

público Lista<PatternItem> . getPattern ()

Obtiene el patrón de trazo de esta polilínea.

Muestra
  • el patrón de trazo.

público Lista<LatLng> . getPoints ()

Devuelve una instantánea de los vértices de esta polilínea en este momento . La lista que se devuelve es una copia de la lista de vértices. Por lo tanto, los cambios en los vértices de la polilínea no se reflejarán en de esta lista ni los cambios que hagas en ella se reflejarán en la polilínea. Para cambiar los vértices de la polilínea, llama a setPoints(List).

público Límite . getStartCap ()

Obtiene el tope en el vértice de inicio de esta polilínea.

Muestra
  • el límite de inicio.

público Objeto getTag ()

Obtiene la etiqueta de la polilínea.

Muestra
  • la etiqueta si se configuró con setTag; null si no se estableció ninguna etiqueta.

público número de punto flotante getWidth ()

Obtiene el ancho de esta polilínea.

Muestra
  • el ancho en píxeles de la pantalla.

público número de punto flotante getZIndex ()

Obtiene el zIndex de esta polilínea.

Muestra
  • el zIndex de la polilínea.

público número entero hashCode ()

público booleano isClickable ()

Obtiene la posibilidad de hacer clics de la polilínea. Si se puede hacer clic en la polilínea, tu app recibirá notificaciones a la GoogleMap.OnPolylineClickListener cuando el usuario hace clic en polilínea. El objeto de escucha de eventos se registra a través de setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Muestra
  • true si se puede hacer clic en la polilínea De lo contrario, muestra false.

público booleano isGeodesic ()

Obtiene si cada segmento de la línea se dibuja como una línea geodésica o no.

Muestra
  • true si cada segmento se dibuja como una línea geodésica; false si cada segmento es dibujada como una línea recta en la proyección de Mercator.

público booleano isVisible ()

Obtiene la visibilidad de esta polilínea.

Muestra
  • la visibilidad de esta polilínea.

público anular quitar ()

Elimina esta polilínea del mapa. Después de eliminar una polilínea, el comportamiento de todas sus no está definido.

público anular setClickable (booleano en el que se puede hacer clic)

Establece la posibilidad de hacer clics de la polilínea. Si se puede hacer clic en la polilínea, tu app recibirá notificaciones a la GoogleMap.OnPolylineClickListener cuando el usuario hace clic en polilínea. El objeto de escucha de eventos se registra a través de setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Parámetros
se le puede hacer clic Nueva configuración de posibilidad de hacer clics para la polilínea

público anular setColor (int color)

Establece el color de esta polilínea.

Parámetros
color el color en formato ARGB

público anular setEndCap (Limitación endCap)

Establece el tope en el vértice final de esta polilínea. El límite final predeterminado es ButtCap.

Parámetros
endCap el extremo. No debe ser null.

público anular setGeodesic (geodésica booleana)

Establece si cada segmento de la línea se dibuja como una línea geodésica o no.

Parámetros
geodésico si es true, cada segmento se dibuja como una línea geodésica. si false, cada segmento se dibuja como una línea recta en la proyección de Mercator.

público anular setJointType (int joinType)

Fija el tipo de unión para todos los vértices de la polilínea, excepto los vértices de inicio y final.

Consulta JointType para ver los valores permitidos. El valor predeterminado DEFAULT usar si el tipo de unión no está definido o no es uno de los valores permitidos.

Parámetros
jointType el tipo de unión.

público anular setPattern (Patrón de lista<PatternItem>)

Establece el patrón de trazo de la polilínea. El patrón de trazo predeterminado es sólido, representado por null

Parámetros
patrón el patrón de trazo.

público anular setPoints (Lista <LatLng> puntos)

Establece los puntos de esta polilínea. Este método tomará una copia de los puntos, así que las mutaciones de points no tendrán ningún efecto en esta polilínea.

Parámetros
puntos Una lista de objetos LatLng que son los vértices de la polilínea

público anular setSpans (Lista de intervalos de <StyleSpan>)

Establece los intervalos de la polilínea.

Parámetros
intervalos

público anular setStartCap (Cap startCap)

Establece el tope en el vértice de inicio de esta polilínea. El límite de inicio predeterminado es ButtCap.

Parámetros
startCap el límite de inicio. No debe ser null.

público anular setTag (Etiqueta de objeto)

Establece la etiqueta de la polilínea.

Puedes usar esta propiedad para asociar un Object arbitrario con esta polilínea. Para ejemplo, el objeto Object puede contener datos sobre lo que representa la polilínea. Es más fácil que almacenar un Map<Polyline, Object> independiente. Como otro ejemplo, puedes asociar un String: Es el ID que corresponde al ID de un conjunto de datos. SDK de Google Maps para Android lee ni escribe esta propiedad. Es tu responsabilidad llamar a setTag(null) para borrar la etiqueta cuando ya no la necesites, para evitar fugas de memoria en tu aplicación.

Parámetros
etiqueta si es nulo, se borra la etiqueta.

público anular setVisible (booleano visible)

Establece la visibilidad de esta polilínea. Cuando no se puede ver, la polilínea no se dibuja, pero se mantiene todas sus demás propiedades.

Parámetros
visible si es true, la polilínea es visible; si es false, no lo es.

público anular setWidth (ancho de número de punto flotante)

Establece el ancho de esta polilínea.

Parámetros
ancho el ancho en píxeles de la pantalla

público anular setZIndex (Índice z de número de punto flotante)

Establece el zIndex de esta polilínea. Las polilíneas con índices z más altos se dibujan encima de aquellas con índices más bajos.

Parámetros
zIndex el zIndex de esta polilínea.