route QML Value Type

Le type « itinéraire » correspond à un itinéraire géographique. En savoir plus...

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 générales sur un itinéraire, telles que sa longueur, la durée estimée du trajet, ainsi que suffisamment d'informations pour afficher une représentation basique de l'itinéraire sur une carte.

L'objet « QGeoRoute » contient également une liste d'objets « routeSegment » qui décrivent plus en détail les différentes sections de l'itinéraire.

La méthode principale pour obtenir des objets « route » est « RouteModel ».

Exemple

Cet exemple montre comment afficher les manœuvres d’un itinéraire dans un objet ` 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 contenant un cadre de délimitation englobant l'intégralité de l'itinéraire.

distance : real

Propriété en lecture seule qui stocke la distance parcourue sur cet itinéraire, en mètres.

extendedAttributes : Object [since QtLocation 5.13]

Cette propriété contient les attributs étendus de la route et se présente sous la forme d'une carte. Ces attributs sont spécifiques au plugin et peuvent être vides.

Consultez la documentation du plugin pour connaître les attributs pris en charge et leur mode d'utilisation.

Remarque : en raison des limitations de l'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 d'attributs ne peut s'effectuer qu'en JavaScript.

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

legIndex : int

Propriété en lecture seule qui contient l'index du tronçon dans la liste des QtLocation::route::legs de l'itinéraire parent. L'index est égal à -1 si cet itinéraire n'est pas un tronçon d'un itinéraire global.

Voir également overallRoute.

legs : list<route> [since QtLocation 5.12]

Renvoie les segments d'itinéraire associés à cet itinéraire. Les segments d'itinéraire sont les sous-itinéraires reliant 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 dans lequel figure ce tronçon.

path : list<coordinate>

Propriété en lecture seule contenant les coordonnées géographiques de cet itinéraire. Les coordonnées sont répertoriées dans l'ordre dans lequel elles seraient parcourues par une personne se déplaçant le long de ce segment de l'itinéraire.

Pour accéder aux segments individuels, vous pouvez utiliser les accesseurs de liste standard : « path.length » indique le nombre d'objets et « path[index commençant à zéro] » renvoie l'objet correspondant.

Voir également QtPositioning::coordinate.

segments : list<routeSegment>

Propriété en lecture seule contenant la liste des objets ` routeSegment ` de cette route.

Pour accéder aux segments individuels, vous pouvez utiliser les accesseurs de liste standard : « segments.length » indique le nombre d'objets et « segments[index commençant à zéro] » renvoie les objets proprement dits.

Voir également routeSegment.

travelTime : int

Propriété en lecture seule qui contient la durée estimée, en secondes, nécessaire pour parcourir cet itinéraire.

Documentation de la méthode

int segmentsCount()

Renvoie le nombre de segments de l'itinéraire

Voir aussi routeSegment.