QGeoRouteRequest Class
La clase `QGeoRouteRequest` representa los parámetros y restricciones que definen una solicitud de información sobre rutas. Más información...
| 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(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) |
Elementos no miembros relacionados
| bool | operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
| bool | operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs) |
Descripción detallada
El estado predeterminado de una instancia de QGeoRouteRequest dará lugar a una solicitud de segmentos de ruta básicos y maniobras de navegación que describan la ruta más rápida en coche que cubra los puntos de ruta indicados.
Puede haber variaciones significativas en las funciones que admiten los distintos proveedores de información de rutas, o incluso en las funciones que admite un mismo proveedor si se utilizan distintos niveles de autorización.
Existen varias funciones en QGeoRoutingManager que pueden utilizarse para comprobar qué características son compatibles con el proveedor y el nivel de autorización actuales.
Véase también QGeoRoutingManager.
Documentación sobre los tipos de miembro
enum QGeoRouteRequest::FeatureType
flags QGeoRouteRequest::FeatureTypes
Define un elemento importante para la planificación de una ruta.
Estos valores se utilizarán junto con QGeoRouteRequest::FeatureWeight para determinar si deben o no formar parte de la ruta.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::NoFeature | 0x00000000 | QGeoRoutingManager::supportedFeatureTypes() lo utiliza para indicar que no se tendrá en cuenta ningún elemento a la hora de planificar la ruta. |
QGeoRouteRequest::TollFeature | 0x00000001 | Tener en cuenta las autopistas de peaje 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 | Tener en cuenta los transbordadores al planificar la ruta. |
QGeoRouteRequest::TunnelFeature | 0x00000010 | Tener en cuenta los túneles al planificar la ruta. |
QGeoRouteRequest::DirtRoadFeature | 0x00000020 | Ten en cuenta los caminos de tierra al planificar la ruta. |
QGeoRouteRequest::ParksFeature | 0x00000040 | Ten en cuenta los parques al planificar la ruta. |
QGeoRouteRequest::MotorPoolLaneFeature | 0x00000080 | Ten en cuenta los carriles para vehículos con más de un ocupante al planificar la ruta. |
QGeoRouteRequest::TrafficFeature | 0x00000100 | Ten en cuenta la situación actual del tráfico al planificar la ruta. Desde la versión 5.10 de QtLocation |
El tipo FeatureTypes es una definición de tipo (typedef) para QFlags<FeatureType>. Almacena una combinación OR de valores de FeatureType.
enum QGeoRouteRequest::FeatureWeight
flags QGeoRouteRequest::FeatureWeights
Define la ponderación que se debe asociar a un elemento durante la planificación de una ruta.
Estos valores se utilizarán junto con QGeoRouteRequest::Feature para determinar si deben formar parte de la ruta o no.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::NeutralFeatureWeight | 0x00000000 | La presencia o ausencia del elemento no afectará a la planificación de la ruta. |
QGeoRouteRequest::PreferFeatureWeight | 0x00000001 | Se darán preferencia a las rutas que contengan el elemento frente a las que no lo contengan. |
QGeoRouteRequest::RequireFeatureWeight | 0x00000002 | Solo se tendrán en cuenta las rutas que incluyan la característica; de lo contrario, no se mostrará ninguna ruta. |
QGeoRouteRequest::AvoidFeatureWeight | 0x00000004 | Se darán preferencia a las rutas que no incluyan el elemento frente a las que sí lo incluyan. |
QGeoRouteRequest::DisallowFeatureWeight | 0x00000008 | Solo 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 una definición de tipo (typedef) para QFlags<FeatureWeight>. Almacena una combinación OR de valores de FeatureWeight.
enum QGeoRouteRequest::ManeuverDetail
flags QGeoRouteRequest::ManeuverDetails
Define la cantidad de información sobre maniobras que debe incluirse en la ruta.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::NoManeuvers | 0x0000 | No se debe incluir ninguna maniobra en la ruta. |
QGeoRouteRequest::BasicManeuvers | 0x0001 | Se incluirán maniobras básicas en la ruta. Esto incluirá « QGeoManeuver::instructionText » (). |
El tipo «ManeuverDetails» es una definición de tipo para «QFlags<ManeuverDetail>». Almacena una combinación OR de valores de «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 | Minimiza la duración del trayecto. |
QGeoRouteRequest::FastestRoute | 0x0002 | Minimizar la duración del trayecto. |
QGeoRouteRequest::MostEconomicRoute | 0x0004 | Minimizar el coste del trayecto. |
QGeoRouteRequest::MostScenicRoute | 0x0008 | Maximizar el potencial paisajístico del trayecto. |
El tipo RouteOptimizations es una definición de tipo (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 sobre los segmentos de la ruta que debe incluirse en la ruta.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::NoSegmentData | 0x0000 | No se debe incluir ningún dato de segmento en la ruta. Una ruta solicitada con este nivel de detalle de segmentos inicializará QGeoRouteSegment::path() como una línea recta entre las posiciones de las instancias anteriores y siguientes de QGeoManeuver. |
QGeoRouteRequest::BasicSegmentData | 0x0001 | Se incluirán datos básicos de los segmentos en la ruta. Esto incluirá QGeoRouteSegment::path(). |
El tipo SegmentDetails es una definición de tipo para QFlags<SegmentDetail>. Almacena una combinación OR de valores de SegmentDetail.
enum QGeoRouteRequest::TravelMode
flags QGeoRouteRequest::TravelModes
Define los medios de transporte que se utilizarán en un itinerario.
| Constante | Valor | Descripción |
|---|---|---|
QGeoRouteRequest::CarTravel | 0x0001 | La ruta se optimizará para alguien que vaya en 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 vaya en camión. |
El tipo TravelModes es una definición de tipo (typedef) para QFlags<TravelMode>. Almacena una combinación OR de valores de TravelMode.
Documentación de las funciones de miembro
[explicit] QGeoRouteRequest::QGeoRouteRequest(const QList<QGeoCoordinate> &waypoints = QList<QGeoCoordinate>())
Crea una solicitud 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)
Crea una solicitud para calcular una ruta entre origin y destination.
[noexcept] QGeoRouteRequest::QGeoRouteRequest(const QGeoRouteRequest &other)
Crea un objeto de solicitud de ruta a partir del contenido de other.
[constexpr noexcept default] QGeoRouteRequest::QGeoRouteRequest(QGeoRouteRequest &&other)
Crea una instancia de ` QGeoRouteRequest`.
[noexcept] QGeoRouteRequest::~QGeoRouteRequest()
Elimina la solicitud.
QDateTime QGeoRouteRequest::departureTime() const
Devuelve la hora de salida indicada en la solicitud.
Véase también setDepartureTime().
QList<QGeoRectangle> QGeoRouteRequest::excludeAreas() const
Devuelve las áreas que la ruta no debe atravesar.
Véase también setExcludeAreas().
QList<QGeoRouteRequest::FeatureType> QGeoRouteRequest::featureTypes() const
Devuelve la lista de elementos que se tendrán en cuenta a la hora de planificar la ruta. No se incluirán los elementos con una ponderación de NeutralFeatureWeight.
QGeoRouteRequest::FeatureWeight QGeoRouteRequest::featureWeight(QGeoRouteRequest::FeatureType featureType) const
Devuelve la ponderación asignada a « featureType » en la planificación de la ruta.
Si no se ha especificado ninguna ponderación 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 ruta.
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, según especifica esta solicitud, 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 ruta.
Véase también setSegmentDetail().
void QGeoRouteRequest::setDepartureTime(const QDateTime &departureTime)
Establece la hora de salida departureTime para el cálculo de la ruta. El backend puede utilizar esta información para calcular una ruta más rápida, por ejemplo, evitando los atascos durante las horas punta.
El valor por defecto es un QDateTime no válido.
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 la ponderación featureWeight a la característica featureType durante la planificación de la ruta.
Por defecto, a todas las características se les asigna una ponderación 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 que se solicitarán a alternatives. Si alternatives es un valor 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 a 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 ruta en segmentDetail.
Véase también segmentDetail().
void QGeoRouteRequest::setTravelModes(QGeoRouteRequest::TravelModes travelModes)
Establece los modos de transporte que deben tenerse en cuenta durante la planificación de la ruta a travelModes.
El valor por defecto es QGeoRouteRequest::CarTravel.
Véase también travelModes().
void QGeoRouteRequest::setWaypoints(const QList<QGeoCoordinate> &waypoints)
Establece waypoints como los puntos de ruta por los que debe pasar la ruta.
Los puntos de ruta deben indicarse en orden, desde el origen hasta el destino.
Esta solicitud no será válida hasta que los puntos de paso 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 medios de transporte que, según especifica esta solicitud, deben tenerse en cuenta durante la planificación de la ruta.
Véase también setTravelModes().
QList<QGeoCoordinate> QGeoRouteRequest::waypoints() const
Devuelve los puntos de ruta 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 dicho objeto.
Elementos no miembros relacionados
[noexcept] bool operator!=(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
Devuelve si las rutas lhs y rhs no son iguales.
[noexcept] bool operator==(const QGeoRouteRequest &lhs, const QGeoRouteRequest &rhs)
Devuelve si las rutas 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.