En esta página

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)
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.

ConstanteValorDescripción
QGeoRouteRequest::NoFeature0x00000000QGeoRoutingManager::supportedFeatureTypes() lo utiliza para indicar que no se tendrá en cuenta ningún elemento a la hora de planificar la ruta.
QGeoRouteRequest::TollFeature0x00000001Tener en cuenta las autopistas de peaje al planificar la ruta.
QGeoRouteRequest::HighwayFeature0x00000002Tener en cuenta las autopistas al planificar la ruta.
QGeoRouteRequest::PublicTransitFeature0x00000004Tener en cuenta el transporte público al planificar la ruta.
QGeoRouteRequest::FerryFeature0x00000008Tener en cuenta los transbordadores al planificar la ruta.
QGeoRouteRequest::TunnelFeature0x00000010Tener en cuenta los túneles al planificar la ruta.
QGeoRouteRequest::DirtRoadFeature0x00000020Ten en cuenta los caminos de tierra al planificar la ruta.
QGeoRouteRequest::ParksFeature0x00000040Ten en cuenta los parques al planificar la ruta.
QGeoRouteRequest::MotorPoolLaneFeature0x00000080Ten en cuenta los carriles para vehículos con más de un ocupante al planificar la ruta.
QGeoRouteRequest::TrafficFeature0x00000100Ten 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.

ConstanteValorDescripción
QGeoRouteRequest::NeutralFeatureWeight0x00000000La presencia o ausencia del elemento no afectará a la planificación de la ruta.
QGeoRouteRequest::PreferFeatureWeight0x00000001Se darán preferencia a las rutas que contengan el elemento frente a las que no lo contengan.
QGeoRouteRequest::RequireFeatureWeight0x00000002Solo se tendrán en cuenta las rutas que incluyan la característica; de lo contrario, no se mostrará ninguna ruta.
QGeoRouteRequest::AvoidFeatureWeight0x00000004Se darán preferencia a las rutas que no incluyan el elemento frente a las que sí lo incluyan.
QGeoRouteRequest::DisallowFeatureWeight0x00000008Solo 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.

ConstanteValorDescripción
QGeoRouteRequest::NoManeuvers0x0000No se debe incluir ninguna maniobra en la ruta.
QGeoRouteRequest::BasicManeuvers0x0001Se 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.

ConstanteValorDescripción
QGeoRouteRequest::ShortestRoute0x0001Minimiza la duración del trayecto.
QGeoRouteRequest::FastestRoute0x0002Minimizar la duración del trayecto.
QGeoRouteRequest::MostEconomicRoute0x0004Minimizar el coste del trayecto.
QGeoRouteRequest::MostScenicRoute0x0008Maximizar 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.

ConstanteValorDescripción
QGeoRouteRequest::NoSegmentData0x0000No 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::BasicSegmentData0x0001Se 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.

ConstanteValorDescripción
QGeoRouteRequest::CarTravel0x0001La ruta se optimizará para alguien que vaya en coche.
QGeoRouteRequest::PedestrianTravel0x0002La ruta se optimizará para alguien que vaya a pie.
QGeoRouteRequest::BicycleTravel0x0004La ruta se optimizará para alguien que vaya en bicicleta.
QGeoRouteRequest::PublicTransitTravel0x0008La ruta se optimizará para alguien que utilice el transporte público.
QGeoRouteRequest::TruckTravel0x0010La 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.