route QML Value Type

Le type d'itinéraire représente un itinéraire géographique. Plus d'informations...

Propriétés

• 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éthodes

• int segmentsCount()

Description détaillée

Un type d'itinéraire contient des informations de haut niveau sur un itinéraire, telles que la longueur de l'itinéraire, le temps de trajet estimé pour l'itinéraire, et suffisamment d'informations pour rendre une image de base de l'itinéraire sur une carte.

L'objet QGeoRoute contient également une liste d'objets routeSegment qui décrivent des sous-sections de l'itinéraire de manière plus détaillée.

Le principal moyen d'acquérir des objets d'itinéraire est RouteModel.

Exemple

Cet exemple montre comment afficher les manœuvres d'un itinéraire sur une carte 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 : "" }
    }
}

Documentation sur les propriétés

bounds : geoRectangle

Propriété en lecture seule qui contient une boîte de délimitation qui englobe l'ensemble de l'itinéraire.

distance : real

Propriété en lecture seule indiquant la distance parcourue par cet itinéraire, en mètres.

extendedAttributes : Object [since QtLocation 5.13]

Cette propriété contient les attributs étendus de l'itinéraire et est une carte. Ces attributs sont spécifiques au plugin et peuvent être vides.

Consultez la documentation du plugin pour savoir quels sont les attributs pris en charge et comment ils doivent être utilisés.

Remarque : en raison des limitations de QQmlPropertyMap, il n'est pas possible de spécifier les attributs de manière déclarative en QML, l'affectation des clés et des valeurs des attributs ne peut être réalisée qu'en JavaScript.

Cette propriété a été introduite dans QtLocation 5.13.

legIndex : int

Propriété en lecture seule qui contient l'index de l'étape dans la liste des QtLocation::route::étapes de l'itinéraire contenant. L'index est -1 si cet itinéraire n'est pas un segment d'un itinéraire global.

Voir aussi overallRoute.

legs : list<route> [since QtLocation 5.12]

Renvoie les étapes de l'itinéraire associées à cet itinéraire. Les étapes de l'itinéraire sont les sous-itinéraires entre deux points de passage adjacents. Le résultat peut être vide si ce niveau de détail n'est pas pris en charge par le backend.

Cette propriété a été introduite dans QtLocation 5.12.

overallRoute : Route

Propriété en lecture seule qui contient l'itinéraire qui contient ce segment.

path : list<coordinate>

Propriété en lecture seule qui contient les coordonnées géographiques de cet itinéraire. Les coordonnées sont listées dans l'ordre dans lequel elles seraient traversées par une personne voyageant le long de ce segment de l'itinéraire.

Pour accéder à des segments individuels, vous pouvez utiliser des accesseurs de liste standard : 'path.length' indique le nombre d'objets et 'path[index à partir de zéro]' donne l'objet actuel.

Voir aussi QtPositioning::coordinate.

segments : list<routeSegment>

Propriété en lecture seule qui contient la liste des objets routeSegment de cet itinéraire.

Pour accéder à des segments individuels, vous pouvez utiliser des accesseurs de liste standard : 'segments.length' indique le nombre d'objets et 'segments[index à partir de zéro]' donne les objets actuels.

Voir aussi routeSegment.

travelTime : int

Propriété en lecture seule qui contient le temps estimé pour parcourir cet itinéraire, en secondes.

Documentation de la méthode

int segmentsCount()

Renvoie le nombre de segments de l'itinéraire

Voir aussi routeSegment.