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) |
Non-membres apparenté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 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.
| Constante | Valeur | Description |
|---|---|---|
QGeoRouteRequest::NoFeature | 0x00000000 | Utilisée par QGeoRoutingManager::supportedFeatureTypes() pour indiquer qu'aucune caractéristique ne sera prise en compte lors de la planification de l'itinéraire. |
QGeoRouteRequest::TollFeature | 0x00000001 | Tenir compte des autoroutes à péage lors de la planification de l'itinéraire. |
QGeoRouteRequest::HighwayFeature | 0x00000002 | Tenir compte des autoroutes lors de la planification de l'itinéraire. |
QGeoRouteRequest::PublicTransitFeature | 0x00000004 | Tenir compte des transports en commun lors de la planification de l'itinéraire. |
QGeoRouteRequest::FerryFeature | 0x00000008 | Tenir compte des ferries lors de la planification de l'itinéraire. |
QGeoRouteRequest::TunnelFeature | 0x00000010 | Tenir compte des tunnels lors de la planification de l'itinéraire. |
QGeoRouteRequest::DirtRoadFeature | 0x00000020 | Tenir compte des chemins de terre lors de la planification de l'itinéraire. |
QGeoRouteRequest::ParksFeature | 0x00000040 | Tenir compte des parcs lors de la planification de l'itinéraire. |
QGeoRouteRequest::MotorPoolLaneFeature | 0x00000080 | Tenir compte des voies réservées aux automobilistes lors de la planification de l'itinéraire. |
QGeoRouteRequest::TrafficFeature | 0x00000100 | Tenir 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.
| Constante | Valeur | Description de la constante |
|---|---|---|
QGeoRouteRequest::NeutralFeatureWeight | 0x00000000 | La présence ou l'absence de l'élément n'affecte pas la planification de l'itinéraire. |
QGeoRouteRequest::PreferFeatureWeight | 0x00000001 | Les itinéraires qui contiennent la caractéristique seront préférés à ceux qui n'en contiennent pas. |
QGeoRouteRequest::RequireFeatureWeight | 0x00000002 | Seuls les itinéraires contenant la caractéristique seront pris en compte, sinon aucun itinéraire ne sera renvoyé. |
QGeoRouteRequest::AvoidFeatureWeight | 0x00000004 | Les itinéraires qui ne contiennent pas la caractéristique seront préférés à ceux qui la contiennent. |
QGeoRouteRequest::DisallowFeatureWeight | 0x00000008 | Seuls 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.
| 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. 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.
| Constante | Valeur | Description de l'optimisation |
|---|---|---|
QGeoRouteRequest::ShortestRoute | 0x0001 | Minimiser 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 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.
| 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() comme une ligne droite entre les positions des instances QGeoManeuver précédente et suivante. |
QGeoRouteRequest::BasicSegmentData | 0x0001 | Des 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.
| Constante | Valeur | Description |
|---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | L'itinéraire sera optimisé pour une personne conduisant une voiture. |
QGeoRouteRequest::PedestrianTravel | 0x0002 | L'itinéraire sera optimisé pour une personne qui marche. |
QGeoRouteRequest::BicycleTravel | 0x0004 | L'itinéraire sera optimisé pour une personne qui se déplace à vélo. |
QGeoRouteRequest::PublicTransitTravel | 0x0008 | L'itinéraire sera optimisé pour une personne qui utilise 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>())
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.