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) yCustomCap
(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 esDEFAULT
. - Patrón de trazo
- Sólido (predeterminado, representado por
null
) o una secuencia de objetosPatternItem
se repita a lo largo de la línea. Tipos dePatternItem
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) yDot
(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
yPolygon
, pero noMarker
s). 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 esfalse
. Si esta se configuró comotrue
, tu app recibirá notificaciones para laGoogleMap.OnPolylineClickListener
registrada a través desetOnPolylineClickListener(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 unMap<Polyline, Object>
separado. Como otro ejemplo, puedes asociar un ID deString
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 |
hashCode()
|
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 | |
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 | |
void | |
void | |
void | |
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)
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, muestrafalse
.
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. |
---|