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) |
Éléments non membres associés
| 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.
| Constante | Valeur | Description |
|---|---|---|
QGeoRouteRequest::NoFeature | 0x00000000 | Utilisé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::TollFeature | 0x00000001 | Prend en compte les autoroutes à péage lors de la planification de l'itinéraire. |
QGeoRouteRequest::HighwayFeature | 0x00000002 | Prendre en compte les autoroutes lors du calcul de l'itinéraire. |
QGeoRouteRequest::PublicTransitFeature | 0x00000004 | Prendre en compte les transports en commun lors de la planification de l'itinéraire. |
QGeoRouteRequest::FerryFeature | 0x00000008 | Prendre en compte les ferries lors du calcul de l'itinéraire. |
QGeoRouteRequest::TunnelFeature | 0x00000010 | Prendre en compte les tunnels lors de la planification de l'itinéraire. |
QGeoRouteRequest::DirtRoadFeature | 0x00000020 | Tenez compte des chemins de terre lors de la planification de l'itinéraire. |
QGeoRouteRequest::ParksFeature | 0x00000040 | Tenez compte des parcs lors de la planification de l'itinéraire. |
QGeoRouteRequest::MotorPoolLaneFeature | 0x00000080 | Tenez compte des voies réservées aux véhicules collectifs lorsque vous planifiez votre itinéraire. |
QGeoRouteRequest::TrafficFeature | 0x00000100 | Tenez 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.
| Constante | Valeur | Description |
|---|---|---|
QGeoRouteRequest::NeutralFeatureWeight | 0x00000000 | La présence ou l'absence de l'élément n'aura aucune incidence sur le calcul de l'itinéraire. |
QGeoRouteRequest::PreferFeatureWeight | 0x00000001 | Les itinéraires contenant l’élément seront privilégiés par rapport à ceux qui ne le contiennent pas. |
QGeoRouteRequest::RequireFeatureWeight | 0x00000002 | Seuls les itinéraires comportant cet élément seront pris en compte ; dans le cas contraire, aucun itinéraire ne sera proposé. |
QGeoRouteRequest::AvoidFeatureWeight | 0x00000004 | Les itinéraires qui ne contiennent pas l’élément seront privilégiés par rapport à ceux qui le contiennent. |
QGeoRouteRequest::DisallowFeatureWeight | 0x00000008 | Seuls 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.
| Constante | Valeur | Description |
|---|---|---|
QGeoRouteRequest::NoManeuvers | 0x0000 | Aucune manœuvre ne doit être incluse dans l'itinéraire. |
QGeoRouteRequest::BasicManeuvers | 0x0001 | Les 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.
| Constante | Valeur | Description |
|---|---|---|
QGeoRouteRequest::ShortestRoute | 0x0001 | Réduire au minimum la longueur du trajet. |
QGeoRouteRequest::FastestRoute | 0x0002 | Minimiser la durée du trajet. |
QGeoRouteRequest::MostEconomicRoute | 0x0004 | Minimiser le coût du trajet. |
QGeoRouteRequest::MostScenicRoute | 0x0008 | Maximiser 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.
| Constante | Valeur | Description |
|---|---|---|
QGeoRouteRequest::NoSegmentData | 0x0000 | Aucune 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::BasicSegmentData | 0x0001 | Des 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.
| Constante | Valeur | Description |
|---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | L'itinéraire sera optimisé pour une personne se déplaçant en voiture. |
QGeoRouteRequest::PedestrianTravel | 0x0002 | L'itinéraire sera optimisé pour une personne se déplaçant à pied. |
QGeoRouteRequest::BicycleTravel | 0x0004 | L'itinéraire sera optimisé pour une personne se déplaçant à vélo. |
QGeoRouteRequest::PublicTransitTravel | 0x0008 | L'itinéraire sera optimisé pour une personne utilisant les transports en commun. |
QGeoRouteRequest::TruckTravel | 0x0010 | L'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.