RouteQuery QML Type

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

• Lista de todos los miembros, incluidos los heredados

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 empaquetar todos los parámetros necesarios para realizar una solicitud a un servicio de enrutamiento, que luego puede rellenar el contenido de un RouteModel.

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

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

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

Ejemplo de uso

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

RouteQuery {
    id: aQuery
}

RouteModel {
    query: aQuery
    autoUpdate: false
}

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

Véase también RouteModel.

Documentación de propiedades

departureTime : date

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

excludedAreas : list<geoRectangle>

Áreas que la ruta no debe cruzar.

Las áreas excluidas pueden establecerse como parte de la declaración del tipo RouteQuery o dinámicamente con 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 al planificar la ruta. Las características con un peso de NeutralFeatureWeight no se devolverán.

• RouteQuery.NoFeature - No se tendrá en cuenta ninguna característica al 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
• RouteQueryPublicTransitFeature - Considera el transporte público al planificar la ruta
• RouteQueryFerryFeature - Tenga en cuenta los transbordadores al planificar la ruta
• RouteQueryTunnelFeature - Tenga en cuenta los túneles al planificar la ruta.
• RouteQueryDirtRoadFeature - Tenga en cuenta los caminos de tierra al planificar la ruta
• RouteQueryParksFeature - Tenga en cuenta los parques al planificar la ruta
• RouteQueryMotorPoolLaneFeature - Tenga en cuenta los carriles para vehículos al planificar la ruta.
• RouteQueryTrafficFeature - Considere 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 encaminamiento.

El valor por defecto es RouteQuery.BasicManeuvers.

numberAlternativeRoutes : int

El número de rutas alternativas solicitadas al solicitar 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 con el operador OR ('|').

El valor por defecto es RouteQuery.FastestRoute.

segmentDetail : enumeration

Nivel de detalle que se utilizará en la representación de los segmentos de ruta.

El valor por defecto es RouteQuery.BasicSegmentData.

travelModes : enumeration

Los modos de viaje que deben tenerse en cuenta durante la planificación de la ruta. Los valores pueden combinarse con el operador OR ('|').

El valor por defecto es RouteQuery.CarTravel.

waypoints : list<coordinate>

Las coordenadas de los waypoints de la ruta deseada. Los waypoints deben indicarse en orden de origen a destino. Se necesitan dos o más coordenadas.

Los waypoints pueden establecerse como parte de la declaración del tipo RouteQuery o dinámicamente con las funciones proporcionadas.

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

Documentación del método

void addExcludedArea(geoRectangle area)

Añade el geoRectangle area especificado a las áreas excluidas (áreas que la ruta no debe cruzar). Sólo se puede añadir una vez la misma zona.

Véase también removeExcludedArea y clearExcludedAreas.

void addWaypoint(coordinate)

Añade la dirección coordinate a la lista de waypoints. La misma coordenada puede establecerse varias veces.

Véase también removeWaypoint y clearWaypoints.

void clearExcludedAreas()

Borra todas las zonas excluidas (zonas que la ruta no debe atravesar).

Véase también addExcludedArea y removeExcludedArea.

void clearWaypoints()

Borra todos los waypoints.

Véase también removeWaypoint y addWaypoint.

FeatureWeight featureWeight(FeatureType featureType)

Obtiene el peso de featureType.

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

void removeExcludedArea(geoRectangle area)

Elimina la dirección area de las zonas excluidas (zonas que la ruta no debe atravesar).

Véase también addExcludedArea y clearExcludedAreas.

void removeWaypoint(coordinate)

Elimina la dirección coordinate de la lista de waypoints. Si la misma coordenada aparece varias veces, se elimina la última coordenada añadida.

Véase también addWaypoint y clearWaypoints.

void resetFeatureWeights()

Restablece todos los pesos de las características a su estado por defecto (NeutralFeatureWeight).

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

void setFeatureWeight(FeatureType feature, FeatureWeight weight)

Define la weight a asociar a una feature durante la planificación de una ruta.

A continuación se enumeran los posibles pesos de las características:

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