En esta página

route QML Value Type

El tipo de ruta representa una ruta geográfica. Más información...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

Propiedades

Métodos

Descripción detallada

Un tipo de ruta contiene información general sobre una ruta, como su longitud, el tiempo estimado de recorrido y datos suficientes para representar una imagen básica de la ruta en un mapa.

El objeto « QGeoRoute » también contiene una lista de objetos « routeSegment » que describen las subsecciones de la ruta con mayor detalle.

La principal forma de obtener objetos de ruta es mediante RouteModel.

Ejemplo

Este ejemplo muestra cómo mostrar las maniobras de una ruta en un ` ListView`:

import QtQuick
import QtPositioning
import QtLocation

RouteModel {
    id: routeModel
    // model initialization
}

ListView {
    id: listview
    anchors.fill: parent
    spacing: 10
    model: routeModel.status == RouteModel.Ready ? routeModel.get(0).segments : null
    visible: model ? true : false
    delegate: Row {
        width: parent.width
        spacing: 10
        property bool hasManeuver : modelData.maneuver && modelData.maneuver.valid
        visible: hasManeuver
        Text { text: (1 + index) + "." }
        Text { text: hasManeuver ? modelData.maneuver.instructionText : "" }
    }
}

Documentación de propiedades

bounds : geoRectangle

Propiedad de solo lectura que contiene un rectángulo delimitador que abarca toda la ruta.

distance : real

Propiedad de solo lectura que contiene la distancia recorrida por esta ruta, en metros.

extendedAttributes : Object [since QtLocation 5.13]

Esta propiedad contiene los atributos ampliados de la ruta y es un mapa. Estos atributos son específicos del complemento y pueden estar vacíos.

Consulta la documentación del complemento para saber qué atributos son compatibles y cómo deben utilizarse.

Ten en cuenta que, debido a las limitaciones de QQmlPropertyMap, no es posible especificar los atributos de forma declarativa en QML; la asignación de claves y valores a los atributos solo puede realizarse mediante JavaScript.

Esta propiedad se introdujo en QtLocation 5.13.

legIndex : int

Propiedad de solo lectura que contiene el índice del tramo dentro de la lista de QtLocation::route::legs de la ruta que lo contiene. El índice es -1 si esta ruta no forma parte de una ruta global.

Véase también overallRoute.

legs : list<route> [since QtLocation 5.12]

Devuelve los tramos de ruta asociados a esta ruta. Los tramos de ruta son las subrutas entre dos puntos de ruta adyacentes. El resultado puede estar vacío si el backend no admite este nivel de detalle.

Esta propiedad se introdujo en QtLocation 5.12.

overallRoute : Route

Propiedad de solo lectura que contiene la ruta en la que se encuentra este tramo.

path : list<coordinate>

Propiedad de solo lectura que contiene las coordenadas geográficas de esta ruta. Las coordenadas aparecen en el orden en que las atravesaría alguien que recorriera este tramo de la ruta.

Para acceder a los segmentos individuales, puedes utilizar los accesores de lista estándar: «path.length» indica el número de objetos y «path[índice a partir de cero]» proporciona el objeto concreto.

Véase también QtPositioning::coordinate.

segments : list<routeSegment>

Propiedad de solo lectura que contiene la lista de objetos ` routeSegment ` de esta ruta.

Para acceder a segmentos individuales, puedes utilizar los accesores de lista estándar: «segments.length» indica el número de objetos y «segments[índice a partir de cero]» proporciona los objetos concretos.

Véase también routeSegment.

travelTime : int

Propiedad de solo lectura que contiene el tiempo estimado que se tardará en recorrer esta ruta, en segundos.

Documentación del método

int segmentsCount()

Devuelve el número de segmentos de la ruta

Véase también routeSegment.

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