QGeoRouteRequest Class
La clase QGeoRouteRequest representa los parámetros y restricciones que definen una solicitud de información de enrutamiento. Más...
| Header: | #include <QGeoRouteRequest> |
| qmake: | QT += location |
Tipos Públicos
| 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 |
Funciones Públicas
| 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) |
No miembros relacionados
| bool | operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
| bool | operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
Descripción detallada
El estado por defecto de una instancia de QGeoRouteRequest resultará en una solicitud de segmento de ruta básico y maniobras de navegación describiendo la ruta más rápida en coche que cubra los waypoints dados.
Puede haber variaciones significativas en las características soportadas por diferentes proveedores de información de rutas, o incluso en las características soportadas por el mismo proveedor si se utilizan diferentes niveles de autorización.
Existen varias funciones en QGeoRoutingManager que pueden utilizarse para comprobar qué funciones son compatibles con el proveedor y el nivel de autorización actuales.
Véase también QGeoRoutingManager.
Documentación de tipos de miembros
enum QGeoRouteRequest::FeatureType
flags QGeoRouteRequest::FeatureTypes
Define una característica que es importante para la planificación de una ruta.
Estos valores se utilizarán en combinación con QGeoRouteRequest::FeatureWeight para determinar si deben o no formar parte de la ruta.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::NoFeature | 0x00000000 | Utilizada por QGeoRoutingManager::supportedFeatureTypes() para indicar que no se tendrá en cuenta ninguna característica al planificar la ruta. |
QGeoRouteRequest::TollFeature | 0x00000001 | Tener en cuenta las autopistas al planificar la ruta. |
QGeoRouteRequest::HighwayFeature | 0x00000002 | Tener en cuenta las autopistas al planificar la ruta. |
QGeoRouteRequest::PublicTransitFeature | 0x00000004 | Tener en cuenta el transporte público al planificar la ruta. |
QGeoRouteRequest::FerryFeature | 0x00000008 | Tenga en cuenta los transbordadores al planificar la ruta. |
QGeoRouteRequest::TunnelFeature | 0x00000010 | Tenga en cuenta los túneles al planificar la ruta. |
QGeoRouteRequest::DirtRoadFeature | 0x00000020 | Tenga en cuenta los caminos de tierra al planificar la ruta. |
QGeoRouteRequest::ParksFeature | 0x00000040 | Tenga en cuenta los parques al planificar la ruta. |
QGeoRouteRequest::MotorPoolLaneFeature | 0x00000080 | Tenga en cuenta los carriles para automóviles al planificar la ruta. |
QGeoRouteRequest::TrafficFeature | 0x00000100 | Tenga en cuenta la situación actual del tráfico al planificar la ruta. Desde QtLocation 5.10 |
El tipo FeatureTypes es un typedef para QFlags<FeatureType>. Almacena una combinación OR de valores FeatureType.
enum QGeoRouteRequest::FeatureWeight
flags QGeoRouteRequest::FeatureWeights
Define el peso a asociar a una característica durante la planificación de una ruta.
Estos valores se utilizarán en combinación con QGeoRouteRequest::Feature para determinar si deben o no formar parte de la ruta.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::NeutralFeatureWeight | 0x00000000 | La presencia o ausencia de la característica no afectará a la planificación de la ruta. |
QGeoRouteRequest::PreferFeatureWeight | 0x00000001 | Las rutas que contengan la característica tendrán preferencia sobre las que no la contengan. |
QGeoRouteRequest::RequireFeatureWeight | 0x00000002 | Sólo se tendrán en cuenta las rutas que contengan la característica; de lo contrario, no se devolverá ninguna ruta. |
QGeoRouteRequest::AvoidFeatureWeight | 0x00000004 | Las rutas que no contengan la característica tendrán preferencia sobre las que sí la contengan. |
QGeoRouteRequest::DisallowFeatureWeight | 0x00000008 | Sólo se tendrán en cuenta las rutas que no contengan la característica, de lo contrario no se devolverá ninguna ruta. |
El tipo FeatureWeights es un typedef para QFlags<FeatureWeight>. Almacena una combinación OR de valores FeatureWeight.
enum QGeoRouteRequest::ManeuverDetail
flags QGeoRouteRequest::ManeuverDetails
Define la cantidad de información sobre maniobras que debe incluirse con la ruta.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::NoManeuvers | 0x0000 | No se deben incluir maniobras con la ruta. |
QGeoRouteRequest::BasicManeuvers | 0x0001 | Se incluirán maniobras básicas con la ruta. Esto incluirá QGeoManeuver::instructionText(). |
El tipo ManeuverDetails es un typedef para QFlags<ManeuverDetail>. Almacena una combinación OR de valores ManeuverDetail.
enum QGeoRouteRequest::RouteOptimization
flags QGeoRouteRequest::RouteOptimizations
Define el tipo de optimización que se aplica a la planificación de la ruta.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::ShortestRoute | 0x0001 | Minimizar la duración del trayecto. |
QGeoRouteRequest::FastestRoute | 0x0002 | Minimizar el tiempo de viaje del trayecto. |
QGeoRouteRequest::MostEconomicRoute | 0x0004 | Minimizar el coste del viaje. |
QGeoRouteRequest::MostScenicRoute | 0x0008 | Maximizar el potencial paisajístico del viaje. |
El tipo RouteOptimizations es un typedef para QFlags<RouteOptimization>. Almacena una combinación OR de valores de RouteOptimization.
enum QGeoRouteRequest::SegmentDetail
flags QGeoRouteRequest::SegmentDetails
Define la cantidad de información de segmento de ruta que debe incluirse con la ruta.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::NoSegmentData | 0x0000 | No se deben incluir datos de segmento con la ruta. Una ruta solicitada con este nivel de detalle de segmento inicializará QGeoRouteSegment::path() como una línea recta entre las posiciones de las instancias QGeoManeuver anterior y siguiente. |
QGeoRouteRequest::BasicSegmentData | 0x0001 | Se incluirán datos de segmento básicos con la ruta. Esto incluirá QGeoRouteSegment::path(). |
El tipo SegmentDetails es un typedef para QFlags<SegmentDetail>. Almacena una combinación OR de valores SegmentDetail.
enum QGeoRouteRequest::TravelMode
flags QGeoRouteRequest::TravelModes
Define los modos de viaje que se utilizarán para una ruta.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | La ruta se optimizará para alguien que conduzca un coche. |
QGeoRouteRequest::PedestrianTravel | 0x0002 | La ruta se optimizará para alguien que vaya a pie. |
QGeoRouteRequest::BicycleTravel | 0x0004 | La ruta se optimizará para alguien que vaya en bicicleta. |
QGeoRouteRequest::PublicTransitTravel | 0x0008 | La ruta se optimizará para alguien que utilice el transporte público. |
QGeoRouteRequest::TruckTravel | 0x0010 | La ruta se optimizará para alguien que conduzca un camión. |
El tipo TravelModes es un typedef para QFlags<TravelMode>. Almacena una combinación OR de valores TravelMode.
Documentación de las funciones miembro
[explicit] QGeoRouteRequest::QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>())
Construye una petición para calcular una ruta a través de las coordenadas waypoints.
La ruta recorrerá los objetos de waypoints en orden.
QGeoRouteRequest::QGeoRouteRequest(const QGeoCoordinate &origin, const QGeoCoordinate &destination)
Construye una petición para calcular una ruta entre origin y destination.
[noexcept] QGeoRouteRequest::QGeoRouteRequest(const QGeoRouteRequest &other)
Construye un objeto de solicitud de ruta a partir del contenido de other.
[noexcept] QGeoRouteRequest::~QGeoRouteRequest()
Destruye la solicitud.
QDateTime QGeoRouteRequest::departureTime() const
Devuelve la hora de salida en la solicitud.
Véase también setDepartureTime().
QList<QGeoRectangle> QGeoRouteRequest::excludeAreas() const
Devuelve las zonas que la ruta no debe atravesar.
Véase también setExcludeAreas().
QList<QGeoRouteRequest::FeatureType> QGeoRouteRequest::featureTypes() const
Devuelve la lista de características que se tendrán en cuenta al planificar la ruta. Las características con un peso de NeutralFeatureWeight no se devolverán.
QGeoRouteRequest::FeatureWeight QGeoRouteRequest::featureWeight(QGeoRouteRequest::FeatureType featureType) const
Devuelve el peso asignado a featureType en la planificación de la ruta.
Si no se ha especificado ningún peso de característica para featureType, se devolverá NeutralFeatureWeight.
Véase también setFeatureWeight().
QGeoRouteRequest::ManeuverDetail QGeoRouteRequest::maneuverDetail() const
Devuelve el nivel de detalle que se utilizará en la representación de las maniobras de enrutamiento.
Véase también setManeuverDetail().
int QGeoRouteRequest::numberAlternativeRoutes() const
Devuelve el número de rutas alternativas que se solicitarán.
Véase también setNumberAlternativeRoutes().
QGeoRouteRequest::RouteOptimizations QGeoRouteRequest::routeOptimization() const
Devuelve los criterios de optimización que esta petición especifica que deben utilizarse al planificar la ruta.
Véase también setRouteOptimization().
QGeoRouteRequest::SegmentDetail QGeoRouteRequest::segmentDetail() const
Devuelve el nivel de detalle que se utilizará en la representación de los segmentos de enrutamiento.
Véase también setSegmentDetail().
void QGeoRouteRequest::setDepartureTime(const QDateTime &departureTime)
Establece la hora de salida departureTime para el cálculo de la ruta. Esta información puede ser utilizada por el backend para calcular una ruta más rápida, por ejemplo, evitando la congestión del tráfico en hora punta.
El valor por defecto es un valor no válido QDateTime.
Véase también departureTime().
void QGeoRouteRequest::setExcludeAreas(const QList<QGeoRectangle> &areas)
Establece areas como zonas excluidas que la ruta no debe atravesar.
Véase también excludeAreas().
void QGeoRouteRequest::setFeatureWeight(QGeoRouteRequest::FeatureType featureType, QGeoRouteRequest::FeatureWeight featureWeight)
Asigna el peso featureWeight a la característica featureType durante la planificación de la ruta.
Por defecto, a todas las características se les asigna un peso de NeutralFeatureWeight.
No es posible asignar un peso a QGeoRouteRequest::NoFeature.
Véase también featureWeight().
void QGeoRouteRequest::setManeuverDetail(QGeoRouteRequest::ManeuverDetail maneuverDetail)
Establece el nivel de detalle que se utilizará al representar las maniobras de enrutamiento en maneuverDetail.
El valor por defecto es QGeoRouteRequest::BasicManeuvers.
Véase también maneuverDetail().
void QGeoRouteRequest::setNumberAlternativeRoutes(int alternatives)
Establece el número de rutas alternativas a solicitar a alternatives. Si alternatives es negativo, el número de rutas alternativas se establece en 0.
El valor por defecto es 0.
Véase también numberAlternativeRoutes().
void QGeoRouteRequest::setRouteOptimization(QGeoRouteRequest::RouteOptimizations optimization)
Establece los criterios de optimización que se utilizarán al planificar la ruta en optimization.
El valor por defecto es QGeoRouteRequest::FastestRoute.
Véase también routeOptimization().
void QGeoRouteRequest::setSegmentDetail(QGeoRouteRequest::SegmentDetail segmentDetail)
Establece el nivel de detalle que se utilizará al representar segmentos de enrutamiento en segmentDetail.
Véase también segmentDetail().
void QGeoRouteRequest::setTravelModes(QGeoRouteRequest::TravelModes travelModes)
Establece los modos de viaje que deben tenerse en cuenta durante la planificación de la ruta en travelModes.
El valor por defecto es QGeoRouteRequest::CarTravel.
Véase también travelModes().
void QGeoRouteRequest::setWaypoints(const QList<QGeoCoordinate> &waypoints)
Establece waypoints como los waypoints por los que debe pasar la ruta.
Los waypoints deben indicarse en orden de origen a destino.
Esta petición no será válida hasta que los waypoints se hayan establecido en una lista que contenga dos o más coordenadas.
Véase también waypoints().
QGeoRouteRequest::TravelModes QGeoRouteRequest::travelModes() const
Devuelve los modos de viaje que esta solicitud especifica que deben tenerse en cuenta durante la planificación de la ruta.
Véase también setTravelModes().
QList<QGeoCoordinate> QGeoRouteRequest::waypoints() const
Devuelve los waypoints por los que pasará la ruta.
Véase también setWaypoints().
[noexcept] QGeoRouteRequest &QGeoRouteRequest::operator=(const QGeoRouteRequest &other)
Asigna other a este objeto de solicitud de ruta y, a continuación, devuelve una referencia a este objeto de solicitud de ruta.
No miembros relacionados
[noexcept] bool operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
Devuelve si las peticiones de ruta lhs y rhs no son iguales.
[noexcept] bool operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
Devuelve si las peticiones de ruta lhs y rhs son iguales.
© 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.
