QGeoRoute Class
La classe QGeoRoute représente un itinéraire entre deux points. En savoir plus…
| Header: | #include <QGeoRoute> |
| qmake: | QT += location |
Propriétés
|
|
Fonctions publiques
| QGeoRoute() | |
| QGeoRoute(const QGeoRoute &other) | |
| QGeoRoute(QGeoRoute &&other) | |
| ~QGeoRoute() | |
| QGeoRectangle | bounds() const |
| qreal | distance() const |
| QVariantMap | extendedAttributes() const |
| QGeoRouteSegment | firstRouteSegment() const |
| int | legIndex() const |
| QGeoRoute | overallRoute() const |
| QList<QGeoCoordinate> | path() const |
| QString | routeId() const |
| QList<QGeoRoute> | routeLegs() const |
| QList<QGeoRouteSegment> | segments() const |
| qsizetype | segmentsCount() const |
| void | setFirstRouteSegment(const QGeoRouteSegment &routeSegment) |
| void | setPath(const QList<QGeoCoordinate> &path) |
| void | setTravelMode(QGeoRouteRequest::TravelMode mode) |
| QGeoRouteRequest::TravelMode | travelMode() const |
| int | travelTime() const |
| QGeoRoute & | operator=(const QGeoRoute &other) |
Fonctions protégées
| QExplicitlySharedDataPointer<QGeoRoutePrivate> & | d() |
Éléments non membres associés
| bool | operator!=(const QGeoRoute &lhs, const QGeoRoute &rhs) |
| bool | operator==(const QGeoRoute &lhs, const QGeoRoute &rhs) |
Description détaillée
Un objet QGeoRoute 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 « QGeoRouteSegment » qui décrivent plus en détail les sous-sections de l'itinéraire.
Les informations de calcul d’itinéraire sont généralement demandées à l’aide de la fonction ` QGeoRoutingManager::calculateRoute()`, qui renvoie une instance de ` QGeoRouteReply `. Si l’opération aboutit, les informations de calcul d’itinéraire sont accessibles via la fonction ` QGeoRouteReply::routes()`.
Voir également QGeoRoutingManager.
Documentation sur les propriétés
[read-only] bounds : const QGeoRectangle
Cette propriété contient le cadre englobant l'itinéraire dans son intégralité
Fonctions d'accès :
| QGeoRectangle | bounds() const |
[read-only] distance : const qreal
Cette propriété indique la distance parcourue sur cet itinéraire, en mètres
Fonctions d'accès :
| qreal | distance() const |
[read-only] extendedAttributes : const QVariantMap
Cette propriété contient les attributs étendus associés à cet itinéraire
Fonctions d'accès :
| QVariantMap | extendedAttributes() const |
[read-only] legIndex : const int
Cette propriété contient l'index du tronçon correspondant à cet itinéraire
L'index de l'étape dans la liste contenante QGeoRoute::routeLegs peut être utilisé pour trouver les étapes suivantes.
Fonctions d’accès :
| int | legIndex() const |
[read-only] overallRoute : const QGeoRoute
Cette propriété contient l'itinéraire qui comprend ce tronçon d'itinéraire
Si cet itinéraire n'est pas un tronçon d'un itinéraire global, cette propriété contient alors un itinéraire vide.
Fonctions d'accès :
| QGeoRoute | overallRoute() const |
path : QList<QGeoCoordinate>
Cette propriété contient la forme géométrique de l'itinéraire
Les coordonnées doivent être 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.
Fonctions d'accès :
| QList<QGeoCoordinate> | path() const |
| void | setPath(const QList<QGeoCoordinate> &path) |
[read-only] routeId : const QString
Cette propriété contient l'identifiant de cet itinéraire
Les fournisseurs de services qui prennent en charge la mise à jour des itinéraires attribuent généralement des identifiants à ces derniers. Si cet itinéraire provient d'un tel fournisseur de services, la modification de l'identifiant entraînera probablement l'interruption des mises à jour de l'itinéraire.
Fonctions d'accès :
| QString | routeId() const |
[read-only] routeLegs : const QList<QGeoRoute>
Cette propriété contient l'legs s relatives à l'itinéraire d'un parcours à plusieurs points de passage
Fonctions d'accès :
| QList<QGeoRoute> | routeLegs() const |
[read-only] segments : const QList<QGeoRouteSegment>
Cette propriété contient la liste des objets « QGeoRouteSegment » de cette route
Fonctions d'accès :
| QList<QGeoRouteSegment> | segments() const |
[read-only] segmentsCount : const qsizetype
Cette propriété indique le nombre de segments de l'itinéraire
Fonctions d'accès :
| qsizetype | segmentsCount() const |
[read-only] travelTime : const int
Cette propriété indique la durée estimée nécessaire pour parcourir cet itinéraire, en secondes
Fonctions d'accès :
| int | travelTime() const |
Documentation des fonctions membres
QGeoRoute::QGeoRoute()
Crée un objet « route ».
[noexcept] QGeoRoute::QGeoRoute(const QGeoRoute &other)
Crée un objet « route » à partir du contenu de other.
[constexpr noexcept default] QGeoRoute::QGeoRoute(QGeoRoute &&other)
Crée par « move » une instance de ` QGeoRoute`.
[noexcept] QGeoRoute::~QGeoRoute()
Supprime cet objet d'itinéraire.
[protected] QExplicitlySharedDataPointer<QGeoRoutePrivate> &QGeoRoute::d()
Renvoie l'implémentation privée.
QGeoRouteSegment QGeoRoute::firstRouteSegment() const
Renvoie le premier segment de l'itinéraire.
Renvoie un segment d'itinéraire non valide s'il n'y a aucun segment d'itinéraire associé à l'itinéraire.
Les segments d’itinéraire restants sont accessibles de manière séquentielle à l’aide de ` QGeoRouteSegment::nextRouteSegment`.
Voir également setFirstRouteSegment().
void QGeoRoute::setFirstRouteSegment(const QGeoRouteSegment &routeSegment)
Définit le premier segment de l'itinéraire vers routeSegment.
Voir aussi firstRouteSegment().
void QGeoRoute::setTravelMode(QGeoRouteRequest::TravelMode mode)
Définit le mode de transport pour cet itinéraire sur « mode ».
Il doit s'agir de l'un des modes de déplacement renvoyés par request().travelModes().
Voir également travelMode().
QGeoRouteRequest::TravelMode QGeoRoute::travelMode() const
Renvoie le mode de transport correspondant à cet itinéraire.
Il doit s'agir de l'un des modes de déplacement renvoyés par request().travelModes().
Voir également ` setTravelMode()`.
[noexcept] QGeoRoute &QGeoRoute::operator=(const QGeoRoute &other)
Attribue le contenu de other à cette route et renvoie une référence à cette route.
© 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.
