Sur cette page

QGeoRouteRequest Class

La classe `QGeoRouteRequest` représente les paramètres et les contraintes qui définissent une requête d'informations de calcul d'itinéraire. En savoir plus...

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

Types publics

enum FeatureType { NoFeature, TollFeature, HighwayFeature, PublicTransitFeature, FerryFeature, …, TrafficFeature }
flags FeatureTypes
enum FeatureWeight { NeutralFeatureWeight, PreferFeatureWeight, RequireFeatureWeight, AvoidFeatureWeight, DisallowFeatureWeight }
flags FeatureWeights
enum ManeuverDetail { NoManeuvers, BasicManeuvers }
flags ManeuverDetails
enum RouteOptimization { ShortestRoute, FastestRoute, MostEconomicRoute, MostScenicRoute }
flags RouteOptimizations
enum SegmentDetail { NoSegmentData, BasicSegmentData }
flags SegmentDetails
enum TravelMode { CarTravel, PedestrianTravel, BicycleTravel, PublicTransitTravel, TruckTravel }
flags TravelModes

Fonctions publiques

QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>())
QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination)
QGeoRouteRequest(const QGeoRouteRequest &other)
QGeoRouteRequest(QGeoRouteRequest &&other)
~QGeoRouteRequest()
QDateTime departureTime() const
QList<QGeoRectangle> excludeAreas() const
QList<QGeoRouteRequest::FeatureType> featureTypes() const
QGeoRouteRequest::FeatureWeight featureWeight(QGeoRouteRequest::FeatureType featureType) const
QGeoRouteRequest::ManeuverDetail maneuverDetail() const
int numberAlternativeRoutes() const
QGeoRouteRequest::RouteOptimizations routeOptimization() const
QGeoRouteRequest::SegmentDetail segmentDetail() const
void setDepartureTime(const QDateTime &departureTime)
void setExcludeAreas(const QList<QGeoRectangle> &areas)
void setFeatureWeight(QGeoRouteRequest::FeatureType featureType, QGeoRouteRequest::FeatureWeight featureWeight)
void setManeuverDetail(QGeoRouteRequest::ManeuverDetail maneuverDetail)
void setNumberAlternativeRoutes(int alternatives)
void setRouteOptimization(QGeoRouteRequest::RouteOptimizations optimization)
void setSegmentDetail(QGeoRouteRequest::SegmentDetail segmentDetail)
void setTravelModes(QGeoRouteRequest::TravelModes travelModes)
void setWaypoints(const QList<QGeoCoordinate> &waypoints)
QGeoRouteRequest::TravelModes travelModes() const
QList<QGeoCoordinate> waypoints() const
QGeoRouteRequest &operator=(const QGeoRouteRequest &other)
bool operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
bool operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)

Description détaillée

L'état par défaut d'une instance QGeoRouteRequest entraîne une requête de segments d'itinéraire de base et de manœuvres de navigation décrivant l'itinéraire le plus rapide en voiture reliant les points de passage indiqués.

Les fonctionnalités prises en charge peuvent varier considérablement d’un fournisseur d’informations de routage à l’autre, voire au sein d’un même fournisseur selon les niveaux d’autorisation utilisés.

QGeoRoutingManager propose plusieurs fonctions permettant de vérifier quelles fonctionnalités sont prises en charge par le fournisseur et le niveau d’autorisation actuels.

Voir également QGeoRoutingManager.

Documentation sur les types de membres

enum QGeoRouteRequest::FeatureType
flags QGeoRouteRequest::FeatureTypes

Définit un élément important pour la planification d’un itinéraire.

Ces valeurs seront utilisées en combinaison avec QGeoRouteRequest::FeatureWeight pour déterminer si ces éléments doivent ou non faire partie de l'itinéraire.

ConstanteValeurDescription
QGeoRouteRequest::NoFeature0x00000000Utilisée par la fonction « QGeoRoutingManager::supportedFeatureTypes » () pour indiquer qu’aucun élément ne sera pris en compte lors de la planification de l’itinéraire.
QGeoRouteRequest::TollFeature0x00000001Prend en compte les autoroutes à péage lors de la planification de l'itinéraire.
QGeoRouteRequest::HighwayFeature0x00000002Prendre en compte les autoroutes lors du calcul de l'itinéraire.
QGeoRouteRequest::PublicTransitFeature0x00000004Prendre en compte les transports en commun lors de la planification de l'itinéraire.
QGeoRouteRequest::FerryFeature0x00000008Prendre en compte les ferries lors du calcul de l'itinéraire.
QGeoRouteRequest::TunnelFeature0x00000010Prendre en compte les tunnels lors de la planification de l'itinéraire.
QGeoRouteRequest::DirtRoadFeature0x00000020Tenez compte des chemins de terre lors de la planification de l'itinéraire.
QGeoRouteRequest::ParksFeature0x00000040Tenez compte des parcs lors de la planification de l'itinéraire.
QGeoRouteRequest::MotorPoolLaneFeature0x00000080Tenez compte des voies réservées aux véhicules collectifs lorsque vous planifiez votre itinéraire.
QGeoRouteRequest::TrafficFeature0x00000100Tenez compte des conditions de circulation actuelles lors de la planification de l'itinéraire. Depuis la version 5.10 d'QtLocation

Le type FeatureTypes est une définition de type (typedef) pour QFlags<FeatureType>. Il stocke une combinaison OU de valeurs FeatureType.

enum QGeoRouteRequest::FeatureWeight
flags QGeoRouteRequest::FeatureWeights

Définit le poids à attribuer à un élément lors de la planification d'un itinéraire.

Ces valeurs seront utilisées conjointement avec QGeoRouteRequest::Feature pour déterminer si ces éléments doivent ou non être inclus dans l'itinéraire.

ConstanteValeurDescription
QGeoRouteRequest::NeutralFeatureWeight0x00000000La présence ou l'absence de l'élément n'aura aucune incidence sur le calcul de l'itinéraire.
QGeoRouteRequest::PreferFeatureWeight0x00000001Les itinéraires contenant l’élément seront privilégiés par rapport à ceux qui ne le contiennent pas.
QGeoRouteRequest::RequireFeatureWeight0x00000002Seuls les itinéraires comportant cet élément seront pris en compte ; dans le cas contraire, aucun itinéraire ne sera proposé.
QGeoRouteRequest::AvoidFeatureWeight0x00000004Les itinéraires qui ne contiennent pas l’élément seront privilégiés par rapport à ceux qui le contiennent.
QGeoRouteRequest::DisallowFeatureWeight0x00000008Seuls les itinéraires ne comportant pas cet élément seront pris en compte ; dans le cas contraire, aucun itinéraire ne sera renvoyé.

Le type FeatureWeights est une définition de type (typedef) pour QFlags<FeatureWeight>. Il stocke une combinaison « OU » de valeurs FeatureWeight.

enum QGeoRouteRequest::ManeuverDetail
flags QGeoRouteRequest::ManeuverDetails

Définit la quantité d'informations de manœuvre à inclure dans l'itinéraire.

ConstanteValeurDescription
QGeoRouteRequest::NoManeuvers0x0000Aucune manœuvre ne doit être incluse dans l'itinéraire.
QGeoRouteRequest::BasicManeuvers0x0001Les manœuvres de base seront incluses dans l'itinéraire. Cela inclut notamment « QGeoManeuver::instructionText » ().

Le type « ManeuverDetails » est une définition de type pour QFlags<ManeuverDetail>. Il stocke une combinaison OR de valeurs « ManeuverDetail ».

enum QGeoRouteRequest::RouteOptimization
flags QGeoRouteRequest::RouteOptimizations

Définit le type d'optimisation appliqué au calcul de l'itinéraire.

ConstanteValeurDescription
QGeoRouteRequest::ShortestRoute0x0001Réduire au minimum la longueur du trajet.
QGeoRouteRequest::FastestRoute0x0002Minimiser la durée du trajet.
QGeoRouteRequest::MostEconomicRoute0x0004Minimiser le coût du trajet.
QGeoRouteRequest::MostScenicRoute0x0008Maximiser le potentiel panoramique du trajet.

Le type RouteOptimizations est une définition de type pour QFlags<RouteOptimization>. Il stocke une combinaison « OU » de valeurs RouteOptimization.

enum QGeoRouteRequest::SegmentDetail
flags QGeoRouteRequest::SegmentDetails

Définit la quantité d'informations sur les segments d'itinéraire à inclure dans l'itinéraire.

ConstanteValeurDescription
QGeoRouteRequest::NoSegmentData0x0000Aucune donnée de segment ne doit être incluse dans l'itinéraire. Un itinéraire demandé avec ce niveau de détail des segments initialisera QGeoRouteSegment::path() sous la forme d'une ligne droite entre les positions des instances précédentes et suivantes de QGeoManeuver.
QGeoRouteRequest::BasicSegmentData0x0001Des données de segment de base seront incluses dans l'itinéraire. Cela inclura QGeoRouteSegment::path().

Le type SegmentDetails est un typedef pour QFlags<SegmentDetail>. Il stocke une combinaison OR de valeurs SegmentDetail.

enum QGeoRouteRequest::TravelMode
flags QGeoRouteRequest::TravelModes

Définit les modes de transport à utiliser pour un itinéraire.

ConstanteValeurDescription
QGeoRouteRequest::CarTravel0x0001L'itinéraire sera optimisé pour une personne se déplaçant en voiture.
QGeoRouteRequest::PedestrianTravel0x0002L'itinéraire sera optimisé pour une personne se déplaçant à pied.
QGeoRouteRequest::BicycleTravel0x0004L'itinéraire sera optimisé pour une personne se déplaçant à vélo.
QGeoRouteRequest::PublicTransitTravel0x0008L'itinéraire sera optimisé pour une personne utilisant les transports en commun.
QGeoRouteRequest::TruckTravel0x0010L'itinéraire sera optimisé pour une personne conduisant un camion.

Le type `TravelModes` est un `typedef` pour ` QFlags<TravelMode>`. Il stocke une combinaison « OU » de valeurs `TravelMode`.

Documentation des fonctions membres

[explicit] QGeoRouteRequest::QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>())

Crée une requête permettant de calculer un itinéraire à partir des coordonnées waypoints.

L'itinéraire traversera les objets de waypoints dans l'ordre.

QGeoRouteRequest::QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination)

Crée une requête permettant de calculer un itinéraire entre origin et destination.

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

Crée un objet de requête d'itinéraire à partir du contenu de other.

[constexpr noexcept default] QGeoRouteRequest::QGeoRouteRequest(QGeoRouteRequest &&other)

Crée par « move » une instance de ` QGeoRouteRequest`.

[noexcept] QGeoRouteRequest::~QGeoRouteRequest()

Supprime la requête.

QDateTime QGeoRouteRequest::departureTime() const

Renvoie l'heure de départ indiquée dans la requête.

Voir également setDepartureTime().

QList<QGeoRectangle> QGeoRouteRequest::excludeAreas() const

Renvoie les zones que l'itinéraire ne doit pas traverser.

Voir également setExcludeAreas().

QList<QGeoRouteRequest::FeatureType> QGeoRouteRequest::featureTypes() const

Renvoie la liste des éléments qui seront pris en compte lors du calcul de l'itinéraire. Les éléments dont la pondération est égale à « NeutralFeatureWeight » ne seront pas inclus dans la liste.

QGeoRouteRequest::FeatureWeight QGeoRouteRequest::featureWeight(QGeoRouteRequest::FeatureType featureType) const

Renvoie la pondération attribuée à featureType lors de la planification de l'itinéraire.

Si aucun poids n'a été spécifié pour featureType, la fonction renvoie alors NeutralFeatureWeight.

Voir également setFeatureWeight().

QGeoRouteRequest::ManeuverDetail QGeoRouteRequest::maneuverDetail() const

Renvoie le niveau de détail qui sera utilisé pour la représentation des manœuvres de routage.

Voir également setManeuverDetail().

int QGeoRouteRequest::numberAlternativeRoutes() const

Renvoie le nombre d'itinéraires alternatifs qui seront demandés.

Voir également setNumberAlternativeRoutes().

QGeoRouteRequest::RouteOptimizations QGeoRouteRequest::routeOptimization() const

Renvoie les critères d'optimisation que cette requête spécifie comme devant être utilisés lors de la planification de l'itinéraire.

Voir également setRouteOptimization().

QGeoRouteRequest::SegmentDetail QGeoRouteRequest::segmentDetail() const

Renvoie le niveau de détail qui sera utilisé pour la représentation des segments de routage.

Voir également setSegmentDetail().

void QGeoRouteRequest::setDepartureTime(const QDateTime &departureTime)

Définit l'heure de départ departureTime pour le calcul de l'itinéraire. Ces informations peuvent être utilisées par le backend pour calculer un itinéraire plus rapide, par exemple en évitant les embouteillages aux heures de pointe.

La valeur par défaut est une QDateTime non valide.

Voir également departureTime().

void QGeoRouteRequest::setExcludeAreas(const QList<QGeoRectangle> &areas)

Définit areas comme zones exclues que l'itinéraire ne doit pas traverser.

Voir également excludeAreas().

void QGeoRouteRequest::setFeatureWeight(QGeoRouteRequest::FeatureType featureType, QGeoRouteRequest::FeatureWeight featureWeight)

Attribue le poids « featureWeight » à la caractéristique « featureType » lors de la planification de l'itinéraire.

Par défaut, toutes les entités se voient attribuer un poids de NeutralFeatureWeight.

Il est impossible d'attribuer un poids à QGeoRouteRequest::NoFeature.

Voir également featureWeight().

void QGeoRouteRequest::setManeuverDetail(QGeoRouteRequest::ManeuverDetail maneuverDetail)

Définit le niveau de détail à utiliser lors de la représentation des manœuvres de routage sur maneuverDetail.

La valeur par défaut est ` QGeoRouteRequest::BasicManeuvers`.

Voir également maneuverDetail().

void QGeoRouteRequest::setNumberAlternativeRoutes(int alternatives)

Définit le nombre d'itinéraires alternatifs à demander à alternatives. Si alternatives est une valeur négative, le nombre d'itinéraires alternatifs est défini sur 0.

La valeur par défaut est 0.

Voir aussi numberAlternativeRoutes().

void QGeoRouteRequest::setRouteOptimization(QGeoRouteRequest::RouteOptimizations optimization)

Définit les critères d'optimisation à utiliser lors de la planification de l'itinéraire vers optimization.

La valeur par défaut est QGeoRouteRequest::FastestRoute.

Voir également routeOptimization().

void QGeoRouteRequest::setSegmentDetail(QGeoRouteRequest::SegmentDetail segmentDetail)

Définit le niveau de détail à utiliser lors de la représentation des segments de routage sur segmentDetail.

Voir également segmentDetail().

void QGeoRouteRequest::setTravelModes(QGeoRouteRequest::TravelModes travelModes)

Définit les modes de transport à prendre en compte lors de la planification de l'itinéraire vers travelModes.

La valeur par défaut est QGeoRouteRequest::CarTravel.

Voir également travelModes().

void QGeoRouteRequest::setWaypoints(const QList<QGeoCoordinate> &waypoints)

Définit waypoints comme points de passage que l'itinéraire doit emprunter.

Les points de passage doivent être indiqués dans l'ordre, de l'origine à la destination.

Cette requête ne sera pas valide tant que les points de passage n'auront pas été définis sous la forme d'une liste contenant au moins deux coordonnées.

Voir également waypoints().

QGeoRouteRequest::TravelModes QGeoRouteRequest::travelModes() const

Renvoie les modes de transport que cette requête spécifie comme devant être pris en compte lors de la planification de l'itinéraire.

Voir également setTravelModes().

QList<QGeoCoordinate> QGeoRouteRequest::waypoints() const

Renvoie les points de passage par lesquels passera l'itinéraire.

Voir aussi setWaypoints().

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

Attribue l'other à cet objet de demande d'itinéraire, puis renvoie une référence à cet objet de demande d'itinéraire.

Éléments non membres associés

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

Indique si les requêtes de route lhs et rhs ne sont pas identiques.

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

Indique si les requêtes de route 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.