route QML Value Type
Le type d'itinéraire représente un itinéraire géographique. Plus d'informations...
| Import Statement: | import QtLocation 6.10 |
| Since: | QtLocation 5.5 |
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 qui contient la distance couverte par cet itinéraire, en mètres.
extendedAttributes : Object |
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 connaître les attributs pris en charge et la manière dont 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'attribution des clés et des valeurs des attributs ne peut se faire 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 de QtLocation::route::tronçons 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.
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 également routeSegment.
© 2025 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.