En esta página

RouteQuery QML Type

El tipo `RouteQuery` se utiliza para proporcionar parámetros de consulta a un ` RouteModel`. Más información...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

Propiedades

Métodos

Descripción detallada

Un RouteQuery se utiliza para agrupar todos los parámetros necesarios para realizar una solicitud a un servicio de enrutamiento, que a su vez puede rellenar el contenido de un RouteModel.

Estos parámetros describen detalles clave de la ruta, como el « waypoints » por el que pasar, el « excludedAreas » que hay que evitar, el « travelModes » en uso, así como preferencias detalladas sobre cómo optimizar la ruta y qué características se deben preferir o evitar a lo largo del trayecto (como autopistas de peaje, autovías, etc.).

Los objetos `RouteQuery` se utilizan exclusivamente para rellenar el valor de la propiedad ` query ` de un ` RouteModel`, lo que permite iniciar el proceso de recuperación para rellenar el modelo.

Algunos complementos pueden permitir o requerir parámetros específicos para funcionar. Para especificar estos parámetros específicos de los complementos, se pueden anidar elementos `MapParameter` dentro de un `RouteQuery`.

Ejemplo de uso

El siguiente fragmento de código muestra un ejemplo incompleto de cómo crear un objeto `RouteQuery` y establecerlo como valor de la propiedad ` query ` de un ` RouteModel`.

RouteQuery {
    id: aQuery
}

RouteModel {
    query: aQuery
    autoUpdate: false
}

Para ver un ejemplo más completo, consulta la documentación del tipo ` RouteModel ` y el ejemplo de `Mapviewer`.

Véase también ` RouteModel`.

Documentación de la propiedad

departureTime : date

La hora de salida que se utilizará al consultar la ruta. El valor por defecto es una fecha no válida, lo que significa que no se utilizará ninguna hora de salida en la consulta.

excludedAreas : list<geoRectangle>

Zonas que la ruta no debe atravesar.

Las zonas excluidas pueden configurarse como parte de la declaración de tipo « RouteQuery » o de forma dinámica mediante las funciones proporcionadas.

Véase también addExcludedArea, removeExcludedArea y clearExcludedAreas.

featureTypes : QList<FeatureType> [read-only]

Lista de características que se tendrán en cuenta a la hora de planificar la ruta. Las características con una ponderación igual a «NeutralFeatureWeight» no se incluirán en el resultado.

  • RouteQuery.NoFeature: no se tendrá en cuenta ningún elemento a la hora de planificar la ruta
  • RouteQuery.TollFeature: se tendrán en cuenta las autopistas de peaje al planificar la ruta
  • RouteQuery.HighwayFeature: se tendrán en cuenta las autopistas al planificar la ruta
  • RouteQuery.PublicTransitFeature: tener en cuenta el transporte público al planificar la ruta
  • RouteQuery.FerryFeature: tener en cuenta los transbordadores al planificar la ruta
  • RouteQuery.TunnelFeature: tener en cuenta los túneles al planificar la ruta
  • RouteQuery.DirtRoadFeature - Tener en cuenta los caminos de tierra al planificar la ruta
  • RouteQuery.ParksFeature - Tener en cuenta los parques al planificar la ruta
  • RouteQuery.MotorPoolLaneFeature - Ten en cuenta los carriles para flotas de vehículos al planificar la ruta
  • RouteQuery.TrafficFeature - Ten en cuenta el tráfico al planificar la ruta

Véase también setFeatureWeight y featureWeight.

maneuverDetail : enumeration

El nivel de detalle que se utilizará en la representación de las maniobras de ruta.

ConstanteDescripción
RouteQuery.NoManeuversNo se debe incluir ninguna maniobra en la ruta
RouteQuery.BasicManeuversSe incluirán maniobras básicas en la ruta

El valor por defecto es « RouteQuery.BasicManeuvers ».

numberAlternativeRoutes : int

El número de rutas alternativas que se solicitan al realizar una búsqueda de rutas. El valor por defecto es 0.

routeOptimizations : enumeration

Las optimizaciones de ruta que deben tenerse en cuenta durante la planificación de la ruta. Los valores pueden combinarse mediante el operador «|» de la investigación operativa (OR).

ConstanteDescripción
RouteQuery.ShortestRouteMinimizar la duración del trayecto
RouteQuery.FastestRouteMinimizar la duración del trayecto
RouteQuery.MostEconomicRouteMinimizar el coste del trayecto
RouteQuery.MostScenicRouteMaximizar el potencial paisajístico del trayecto

El valor por defecto es RouteQuery.FastestRoute.

segmentDetail : enumeration

El nivel de detalle que se utilizará en la representación de los segmentos de trazado.

ConstanteDescripción
RouteQuery.NoSegmentDataNo se deben incluir datos de segmentos en la ruta
RouteQuery.BasicSegmentDataSe incluirán datos básicos de los segmentos en la ruta

El valor por defecto es « RouteQuery.BasicSegmentData ».

travelModes : enumeration

Los modos de transporte que deben tenerse en cuenta a la hora de planificar el itinerario. Los valores pueden combinarse mediante el operador OR («|»).

ConstanteDescripción
RouteQuery.CarTravelLa ruta se optimizará para alguien que vaya en coche
RouteQuery.PedestrianTravelLa ruta se optimizará para alguien que vaya a pie
RouteQuery.BicycleTravelLa ruta se optimizará para alguien que vaya en bicicleta
RouteQuery.PublicTransitDesplazamiento La ruta se optimizará para alguien que utilice el transporte público
RouteQuery.TruckTravelLa ruta se optimizará para alguien que vaya en camión

El valor por defecto es « RouteQuery.CarTravel ».

waypoints : list<coordinate>

Las coordenadas de los puntos de ruta de la ruta deseada. Los puntos de ruta deben indicarse en orden, desde el origen hasta el destino. Se necesitan dos o más coordenadas.

Los puntos de ruta se pueden establecer como parte de la declaración de tipo RouteQuery o de forma dinámica mediante las funciones proporcionadas.

Véase también addWaypoint, removeWaypoint y clearWaypoints.

Documentación de métodos

void addExcludedArea(geoRectangle area)

Añade las áreas especificadas geoRectangle area a las áreas excluidas (áreas por las que la ruta no debe pasar). Una misma área solo se puede añadir una vez.

Véase también removeExcludedArea y clearExcludedAreas.

void addWaypoint(coordinate)

Añade las coordenadas coordinate indicadas a la lista de puntos de ruta. Se puede introducir la misma coordenada varias veces.

Véase también removeWaypoint y clearWaypoints.

void clearExcludedAreas()

Elimina todas las zonas excluidas (zonas por las que la ruta no debe pasar).

Véase también addExcludedArea y removeExcludedArea.

void clearWaypoints()

Borra todos los puntos de ruta.

Véase también removeWaypoint y addWaypoint.

FeatureWeight featureWeight(FeatureType featureType)

Obtiene el peso correspondiente a featureType.

Véase también featureTypes, setFeatureWeight y resetFeatureWeights.

void removeExcludedArea(geoRectangle area)

Elimina el « area » indicado de las zonas excluidas (zonas por las que la ruta no debe pasar).

Véase también « addExcludedArea » y « clearExcludedAreas ».

void removeWaypoint(coordinate)

Elimina las coordenadas especificadas coordinate de la lista de puntos de ruta. Si una misma coordenada aparece varias veces, se elimina la que se haya añadido más recientemente.

Véase también addWaypoint y clearWaypoints.

void resetFeatureWeights()

Restablece todas las ponderaciones de características a su estado predeterminado (NeutralFeatureWeight).

Véase también featureTypes, setFeatureWeight y featureWeight.

void setFeatureWeight(FeatureType feature, FeatureWeight weight)

Define el « weight » que se asociará a un « feature » durante la planificación de una ruta.

A continuación se enumeran las posibles ponderaciones de los elementos:

ConstanteDescripción
RouteQuery.NeutralFeatureWeightLa presencia o ausencia del elemento no afecta a la planificación de la ruta
RouteQuery.PreferFeatureWeightSe dan preferencia a las rutas que contienen la característica frente a las que no la contienen
RouteQuery.RequireFeatureWeightSolo se tienen en cuenta las rutas que contienen la característica; de lo contrario, no se devolverá ninguna ruta
RouteQuery.AvoidFeatureWeightSe dan preferencia a las rutas que no contienen la característica frente a las que sí la contienen
RouteQuery.DisallowFeatureWeightSolo se tienen en cuenta las rutas que no contienen el elemento; de lo contrario, no se devolverá ninguna ruta

Véase también featureTypes, resetFeatureWeights y featureWeight.

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