En esta página

MapRoute QML Type

El tipo MapRoute muestra una ruta en un mapa. Más información...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.0

Propiedades

Descripción detallada

El tipo MapRoute muestra en el mapa una ruta obtenida a través de RouteModel u otros medios, en forma de polilínea que sigue el trazado de la ruta.

MapRoute es, en realidad, un objeto de tipo « MapPolyline », pero en el que el trazado se especifica mediante la propiedad « route » en lugar de directamente en « coordinates ».

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

Ejemplo de uso

A continuación se muestra cómo dibujar una « route » sobre una « map »:

import QtQuick
import QtPositioning
import QtLocation

Map {
    RouteModel {
        id: routeModel
    }

    MapItemView {
        model: routeModel
        delegate: routeDelegate
    }

    Component {
        id: routeDelegate

        MapRoute {
            route: routeData
            line.color: "blue"
            line.width: 5
            smooth: true
            opacity: 0.8
        }
    }
}

Documentación de las propiedades

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.

route : Route

Esta propiedad contiene la ruta que se va a trazar, la cual puede utilizarse para representar una ruta geográfica.

© 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.