En esta página

MapPolyline QML Type

El tipo MapPolyline muestra una polilínea en un mapa. Más...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.0

Propiedades

Métodos

Descripción detallada

El tipo MapPolyline muestra una polilínea en un mapa, especificada mediante una lista ordenada de objetos ` coordinates`.

Las coordenadas se pueden añadir o eliminar en cualquier momento mediante los métodos ` addCoordinate ` y ` removeCoordinate `. También se pueden modificar como cualquier otro elemento de lista en QML:

mapPolyline.path[0].latitude = 5;

Por defecto, la polilínea se muestra como una línea negra de 1 píxel de grosor. Esto se puede cambiar utilizando las propiedades line.width y line.color.

Ejemplo de uso

El siguiente fragmento de código muestra una MapPolyline con 4 puntos, que forma una figura parecida a la parte superior de un «signo de interrogación» (?), cerca de Brisbane, Australia. La línea trazada tiene 3 píxeles de ancho y es de color verde.

Map {
    MapPolyline {
        line.width: 3
        line.color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 },
            { latitude: -29, longitude: 153.5 }
        ]
    }
}

Polilínea verde en un mapa

Documentación de las propiedades

autoFadeIn : bool

Esta propiedad determina si el elemento aparece gradualmente al ampliar el mapa partiendo de niveles de zoom muy bajos. Por defecto, el valor es « true ». Si se establece esta propiedad en « false », el elemento del mapa tendrá siempre la opacidad especificada con la propiedad « QtQuick::Item::opacity », cuyo valor por defecto es 1,0.

line group

line.color : color

line.width : int

Esta propiedad forma parte del grupo de propiedades de línea. El grupo de propiedades de línea contiene el ancho y el color que se utilizan para dibujar la línea.

El ancho se expresa en píxeles y es independiente del nivel de zoom del mapa. Los valores predeterminados corresponden a un borde negro con un ancho de 1 píxel.

Para que no aparezca ninguna línea, utiliza un ancho de 0 o un color transparente.

path : list<coordinate>

Esta propiedad contiene la lista ordenada de coordenadas que definen la polilínea.

referenceSurface : enum [since 6.5]

Esta propiedad determina la superficie de referencia de la polilínea. Si se establece en « QLocation::ReferenceSurface::Map », los vértices de la polilínea se conectan mediante líneas rectas en el mapa. Si se establece en « QLocation::ReferenceSurface::Globe », los vértices se conectan siguiendo la trayectoria del gran círculo, que describe la conexión más corta entre dos puntos en una esfera. El valor por defecto es « QLocation::ReferenceSurface::Map ».

Esta propiedad se introdujo en Qt 6.5.

Documentación del método

void addCoordinate(coordinate)

Añade el « coordinate » especificado al final de la ruta.

Véase también insertCoordinate, removeCoordinate y path.

[since QtLocation 5.6] coordinate containsCoordinate(coordinate)

Devuelve «true» si el « coordinate » indicado forma parte de la ruta.

Este método se introdujo en QtLocation 5.6.

[since QtLocation 5.6] coordinate coordinateAt(index)

Obtiene la coordenada de la polilínea en el índice dado index. Si el índice se encuentra fuera de los límites de la ruta, se devuelve una coordenada no válida.

Este método se introdujo en QtLocation 5.6.

[since QtLocation 5.6] void insertCoordinate(index, coordinate)

Inserta un objeto ` coordinate ` en la ruta indicada en ` index`.

Este método se introdujo en QtLocation 5.6.

Véase también addCoordinate, removeCoordinate y path.

[since QtLocation 5.6] int pathLength()

Devuelve el número de coordenadas de la polilínea.

Este método se introdujo en QtLocation 5.6.

Véase también path.

void removeCoordinate(coordinate)

Elimina coordinate de la ruta. Si hay varias entradas con la misma coordenada, se elimina la que se haya añadido en último lugar.

Si coordinate no está en la ruta, este método no realiza ninguna acción.

Véase también addCoordinate, insertCoordinate y path.

[since QtLocation 5.6] void removeCoordinate(index)

Elimina una coordenada de la ruta en el punto indicado index.

Si index no es válido, este método no realiza ninguna acción.

Este método se introdujo en QtLocation 5.6.

Véase también addCoordinate, insertCoordinate y path.

[since QtLocation 5.6] void replaceCoordinate(index, coordinate)

Sustituye la coordenada de la ruta actual en el punto dado index por la nueva coordinate.

Este método se introdujo en QtLocation 5.6.

Véase también addCoordinate, insertCoordinate, removeCoordinate y path.

void setPath(geoPath path)

Establece el valor de « path » utilizando un tipo « geoPath ».

Véase también ` path`.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.