route QML Value Type

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

Propiedades

• bounds : geoRectangle
• distance : real
• extendedAttributes : Object (since QtLocation 5.13)
• legIndex : int
• legs : list<route> (since QtLocation 5.12)
• overallRoute : Route
• path : list<coordinate>
• segments : list<routeSegment>
• travelTime : int

Métodos

• int segmentsCount()

Descripción detallada

Un tipo de ruta contiene información de alto nivel sobre una ruta, como la longitud de la ruta, el tiempo de viaje estimado para la ruta y suficiente información 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 subsecciones de la ruta con mayor detalle.

El principal medio para adquirir objetos de ruta es RouteModel.

Ejemplo

Este ejemplo muestra cómo mostrar las maniobras de una ruta en un objeto 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 sólo lectura que contiene un cuadro delimitador que abarca toda la ruta.

distance : real

Propiedad de sólo lectura que contiene la distancia recorrida por esta ruta, en metros.

extendedAttributes : Object [since QtLocation 5.13]

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

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

Nota, debido a las limitaciones de QQmlPropertyMap, no es posible especificar declarativamente los atributos en QML, la asignación de claves y valores de atributos sólo puede realizarse mediante JavaScript.

Esta propiedad se introdujo en QtLocation 5.13.

legIndex : int

Propiedad de sólo lectura que contiene el índice del tramo dentro de la lista de tramos de QtLocation::route::legs de la ruta contenedora. El índice es -1 si esta ruta no es un tramo dentro 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 sub-rutas entre dos waypoints adyacentes. El resultado puede estar vacío, si el backend no soporta este nivel de detalle.

Esta propiedad se introdujo en QtLocation 5.12.

overallRoute : Route

Propiedad de sólo lectura que contiene la ruta que contiene este tramo.

path : list<coordinate>

Propiedad de sólo lectura que contiene las coordenadas geográficas de esta ruta. Las coordenadas se listan en el orden en que serían recorridas por alguien que viajara a lo largo de este segmento de la ruta.

Para acceder a segmentos individuales se pueden utilizar accesores de lista estándar: 'ruta.longitud' indica el número de objetos y 'ruta[índice empezando por cero]' da el objeto real.

Véase también QtPositioning::coordinate.

segments : list<routeSegment>

Propiedad de sólo lectura que contiene la lista de objetos routeSegment de esta ruta.

Para acceder a segmentos individuales se pueden utilizar accesores de lista estándar: 'segments.length' indica el número de objetos y 'segments[index starting from zero]' da los objetos reales.

Véase también routeSegment.

travelTime : int

Propiedad de sólo lectura que contiene la cantidad estimada de tiempo 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.