Sur cette page

QGeoRoute Class

La classe QGeoRoute représente un itinéraire entre deux points. Plus d'informations...

Header: #include <QGeoRoute>
qmake: QT += location

Propriétés

Fonctions publiques

QGeoRoute()
QGeoRoute(const 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()
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 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 QGeoRouteSegment qui décrivent des sous-sections de l'itinéraire de manière plus détaillée.

Les informations sur les itinéraires sont normalement demandées à l'aide de QGeoRoutingManager::calculateRoute(), qui renvoie une instance QGeoRouteReply. Si l'opération est réussie, les informations d'acheminement peuvent être consultées à l'aide de QGeoRouteReply::routes().

Voir aussi QGeoRoutingManager.

Documentation sur les propriétés

[read-only] bounds : const QGeoRectangle

Cette propriété contient la boîte de délimitation qui englobe l'ensemble de l'itinéraire.

Fonctions d'accès :

QGeoRectangle bounds() const

[read-only] distance : const qreal

Cette propriété contient la distance parcourue par 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 de l'étape de cet itinéraire

L'index de l'étape à l'intérieur de la liste 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 contient ce segment d'itinéraire

Si cet itinéraire n'est pas un segment d'un itinéraire global, cette propriété contient 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 listées dans l'ordre dans lequel elles seraient traversées par une personne voyageant sur 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 aux itinéraires. Si cet itinéraire provient d'un tel fournisseur de services, la modification de l'identifiant entraînera probablement l'arrêt de la mise à jour des itinéraires.

Fonctions d'accès :

QString routeId() const

[read-only] routeLegs : const QList<QGeoRoute>

Cette propriété contient l'itinéraire legs pour un itinéraire à 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 cet itinéraire.

Fonctions d'accès :

QList<QGeoRouteSegment> segments() const

[read-only] segmentsCount : const qsizetype

Cette propriété contient le nombre de segments dans l'itinéraire

Fonctions d'accès :

qsizetype segmentsCount() const

[read-only] travelTime : const int

Cette propriété contient le temps estimé pour parcourir cet itinéraire, en secondes.

Fonctions d'accès :

int travelTime() const

Documentation des fonctions membres

QGeoRoute::QGeoRoute()

Construit un objet route.

[noexcept] QGeoRoute::QGeoRoute(const QGeoRoute &other)

Construit un objet route à partir du contenu de other.

[noexcept] QGeoRoute::~QGeoRoute()

Détruit cet objet route.

[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 pas de segments d'itinéraire associés à l'itinéraire.

Les autres segments de l'itinéraire peuvent être accédés séquentiellement avec QGeoRouteSegment::nextRouteSegment.

Voir aussi setFirstRouteSegment().

void QGeoRoute::setFirstRouteSegment(const QGeoRouteSegment &routeSegment)

Définit le premier segment de l'itinéraire à routeSegment.

Voir aussi firstRouteSegment().

void QGeoRoute::setTravelMode(QGeoRouteRequest::TravelMode mode)

Définit le mode de déplacement pour cet itinéraire à mode.

Il doit s'agir d'un des modes de déplacement renvoyés par request().travelModes().

Voir aussi travelMode().

QGeoRouteRequest::TravelMode QGeoRoute::travelMode() const

Renvoie le mode de déplacement pour cet itinéraire.

Il doit s'agir d'un des modes de déplacement renvoyés par request().travelModes().

Voir aussi setTravelMode().

[noexcept] QGeoRoute &QGeoRoute::operator=(const QGeoRoute &other)

Affecte le contenu de other à cet itinéraire et renvoie une référence à cet itinéraire.

Non-membres apparentés

[noexcept] bool operator!=(const QGeoRoute &lhs, const QGeoRoute &rhs)

Retourne si les routes lhs et rhs ne sont pas égales.

[noexcept] bool operator==(const QGeoRoute &lhs, const QGeoRoute &rhs)

Indique si les itinéraires lhs et rhs sont identiques.

© 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.