Sur cette page

QGeoRouteRequest Class

La classe QGeoRouteRequest représente les paramètres et les restrictions qui définissent une demande d'informations de routage. Plus d'informations...

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()
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 de QGeoRouteRequest se traduit par une demande de segment d'itinéraire de base et de manœuvres de navigation décrivant l'itinéraire le plus rapide en voiture qui couvre les points de repère donnés.

Il peut y avoir des variations significatives dans les fonctionnalités prises en charge par différents fournisseurs d'informations de routage, ou même dans les fonctionnalités prises en charge par le même fournisseur si différents niveaux d'autorisation sont utilisés.

Plusieurs fonctions du site QGeoRoutingManager permettent de vérifier les fonctionnalités 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 une caractéristique importante pour la planification d'un itinéraire.

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

ConstanteValeurDescription
QGeoRouteRequest::NoFeature0x00000000Utilisée par QGeoRoutingManager::supportedFeatureTypes() pour indiquer qu'aucune caractéristique ne sera prise en compte lors de la planification de l'itinéraire.
QGeoRouteRequest::TollFeature0x00000001Tenir compte des autoroutes à péage lors de la planification de l'itinéraire.
QGeoRouteRequest::HighwayFeature0x00000002Tenir compte des autoroutes lors de la planification de l'itinéraire.
QGeoRouteRequest::PublicTransitFeature0x00000004Tenir compte des transports en commun lors de la planification de l'itinéraire.
QGeoRouteRequest::FerryFeature0x00000008Tenir compte des ferries lors de la planification de l'itinéraire.
QGeoRouteRequest::TunnelFeature0x00000010Tenir compte des tunnels lors de la planification de l'itinéraire.
QGeoRouteRequest::DirtRoadFeature0x00000020Tenir compte des chemins de terre lors de la planification de l'itinéraire.
QGeoRouteRequest::ParksFeature0x00000040Tenir compte des parcs lors de la planification de l'itinéraire.
QGeoRouteRequest::MotorPoolLaneFeature0x00000080Tenir compte des voies réservées aux automobilistes lors de la planification de l'itinéraire.
QGeoRouteRequest::TrafficFeature0x00000100Tenir compte de la situation actuelle du trafic lors de la planification de l'itinéraire. Depuis QtLocation 5.10

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

enum QGeoRouteRequest::FeatureWeight
flags QGeoRouteRequest::FeatureWeights

Définit le poids à associer à une caractéristique lors de la planification d'un itinéraire.

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

ConstanteValeurDescription de la constante
QGeoRouteRequest::NeutralFeatureWeight0x00000000La présence ou l'absence de l'élément n'affecte pas la planification de l'itinéraire.
QGeoRouteRequest::PreferFeatureWeight0x00000001Les itinéraires qui contiennent la caractéristique seront préférés à ceux qui n'en contiennent pas.
QGeoRouteRequest::RequireFeatureWeight0x00000002Seuls les itinéraires contenant la caractéristique seront pris en compte, sinon aucun itinéraire ne sera renvoyé.
QGeoRouteRequest::AvoidFeatureWeight0x00000004Les itinéraires qui ne contiennent pas la caractéristique seront préférés à ceux qui la contiennent.
QGeoRouteRequest::DisallowFeatureWeight0x00000008Seuls les itinéraires ne contenant pas la caractéristique seront pris en compte, sinon aucun itinéraire ne sera renvoyé.

Le type FeatureWeights est un typedef pour QFlags<FeatureWeight>. Il stocke une combinaison OU de valeurs FeatureWeights.

enum QGeoRouteRequest::ManeuverDetail
flags QGeoRouteRequest::ManeuverDetails

Définit la quantité d'informations sur les manœuvres à 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. Il s'agit notamment de QGeoManeuver::instructionText().

Le type ManeuverDetails est un typedef pour QFlags<ManeuverDetail>. Il stocke une combinaison OU de valeurs ManeuverDetail.

enum QGeoRouteRequest::RouteOptimization
flags QGeoRouteRequest::RouteOptimizations

Définit le type d'optimisation appliqué à la planification de l'itinéraire.

ConstanteValeurDescription de l'optimisation
QGeoRouteRequest::ShortestRoute0x0001Minimiser la longueur du trajet.
QGeoRouteRequest::FastestRoute0x0002Minimiser la durée du trajet.
QGeoRouteRequest::MostEconomicRoute0x0004Minimiser le coût du trajet.
QGeoRouteRequest::MostScenicRoute0x0008Maximiser le potentiel scénique du trajet.

Le type RouteOptimizations est un typedef 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 de l'itinéraire qui doivent être incluses 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() comme une ligne droite entre les positions des instances QGeoManeuver précédente et suivante.
QGeoRouteRequest::BasicSegmentData0x0001Des données de base sur les segments seront incluses dans l'itinéraire. Il s'agit notamment de QGeoRouteSegment::path().

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

enum QGeoRouteRequest::TravelMode
flags QGeoRouteRequest::TravelModes

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

ConstanteValeurDescription
QGeoRouteRequest::CarTravel0x0001L'itinéraire sera optimisé pour une personne conduisant une voiture.
QGeoRouteRequest::PedestrianTravel0x0002L'itinéraire sera optimisé pour une personne qui marche.
QGeoRouteRequest::BicycleTravel0x0004L'itinéraire sera optimisé pour une personne qui se déplace à vélo.
QGeoRouteRequest::PublicTransitTravel0x0008L'itinéraire sera optimisé pour une personne qui utilise 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>())

Construit une requête pour calculer un itinéraire à travers les coordonnées waypoints.

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

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

Construit une requête pour calculer un itinéraire entre origin et destination.

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

Construit un objet de demande d'itinéraire à partir du contenu de other.

[noexcept] QGeoRouteRequest::~QGeoRouteRequest()

Détruit la demande.

QDateTime QGeoRouteRequest::departureTime() const

Renvoie l'heure de départ dans la demande.

Voir aussi 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 caractéristiques qui seront prises en compte lors de la planification de l'itinéraire. Les caractéristiques ayant un poids de NeutralFeatureWeight ne seront pas renvoyées.

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

Renvoie le poids attribué à featureType dans la planification de l'itinéraire.

Si aucun poids n'a été spécifié pour featureType, NeutralFeatureWeight sera renvoyé.

Voir aussi setFeatureWeight().

QGeoRouteRequest::ManeuverDetail QGeoRouteRequest::maneuverDetail() const

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

Voir aussi 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 demande spécifie ê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é dans la représentation des segments de routage.

Voir aussi setSegmentDetail().

void QGeoRouteRequest::setDepartureTime(const QDateTime &departureTime)

Définit l'heure de départ departureTime pour le calcul de l'itinéraire. Cette information peut être utilisée 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 valeur invalide QDateTime.

Voir également departureTime().

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

Définit areas comme des 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 caractéristiques se voient attribuer un poids de NeutralFeatureWeight.

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

Voir aussi featureWeight().

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

Définit le niveau de détail à utiliser pour représenter les manœuvres de routage à maneuverDetail.

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

Voir aussi maneuverDetail().

void QGeoRouteRequest::setNumberAlternativeRoutes(int alternatives)

Définit le nombre d'itinéraires alternatifs à demander à alternatives. Si alternatives est négatif, le nombre d'itinéraires alternatifs est fixé à 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 aussi 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 aussi segmentDetail().

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

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

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

Voir également travelModes().

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

Définit waypoints comme les points de passage par lesquels l'itinéraire doit passer.

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

Cette demande ne sera pas valide tant que les points de passage n'auront pas été définis dans une liste contenant au moins deux coordonnées.

Voir aussi waypoints().

QGeoRouteRequest::TravelModes QGeoRouteRequest::travelModes() const

Renvoie les modes de déplacement qui, selon cette demande, devraient ê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 l'itinéraire passera.

Voir également setWaypoints().

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

Attribue other à cet objet de demande d'itinéraire et renvoie ensuite une référence à cet objet de demande d'itinéraire.

Non-membres associés

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

Indique si les demandes d'itinéraires lhs et rhs sont différentes.

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

Indique si les demandes d'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.