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
- departureTime : date
- excludedAreas : list<geoRectangle>
- featureTypes : QList<FeatureType>
- maneuverDetail : enumeration
- numberAlternativeRoutes : int
- routeOptimizations : enumeration
- segmentDetail : enumeration
- travelModes : enumeration
- waypoints : list<coordinate>
Métodos
- void addExcludedArea(geoRectangle area)
- void addWaypoint(coordinate)
- void clearExcludedAreas()
- void clearWaypoints()
- FeatureWeight featureWeight(FeatureType featureType)
- void removeExcludedArea(geoRectangle area)
- void removeWaypoint(coordinate)
- void resetFeatureWeights()
- void setFeatureWeight(FeatureType feature, FeatureWeight weight)
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.
| Constante | Descripción |
|---|---|
RouteQuery.NoManeuvers | No se debe incluir ninguna maniobra en la ruta |
RouteQuery.BasicManeuvers | Se 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).
| Constante | Descripción |
|---|---|
RouteQuery.ShortestRoute | Minimizar la duración del trayecto |
RouteQuery.FastestRoute | Minimizar la duración del trayecto |
RouteQuery.MostEconomicRoute | Minimizar el coste del trayecto |
RouteQuery.MostScenicRoute | Maximizar 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.
| Constante | Descripción |
|---|---|
RouteQuery.NoSegmentData | No se deben incluir datos de segmentos en la ruta |
RouteQuery.BasicSegmentData | Se 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 («|»).
| Constante | Descripción |
|---|---|
RouteQuery.CarTravel | La ruta se optimizará para alguien que vaya en coche |
RouteQuery.PedestrianTravel | La ruta se optimizará para alguien que vaya a pie |
RouteQuery.BicycleTravel | La ruta se optimizará para alguien que vaya en bicicleta |
RouteQuery.PublicTransit | Desplazamiento La ruta se optimizará para alguien que utilice el transporte público |
RouteQuery.TruckTravel | La 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:
| Constante | Descripción |
|---|---|
RouteQuery.NeutralFeatureWeight | La presencia o ausencia del elemento no afecta a la planificación de la ruta |
RouteQuery.PreferFeatureWeight | Se dan preferencia a las rutas que contienen la característica frente a las que no la contienen |
RouteQuery.RequireFeatureWeight | Solo se tienen en cuenta las rutas que contienen la característica; de lo contrario, no se devolverá ninguna ruta |
RouteQuery.AvoidFeatureWeight | Se dan preferencia a las rutas que no contienen la característica frente a las que sí la contienen |
RouteQuery.DisallowFeatureWeight | Solo 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.