RouteQuery QML Type

Le type RouteQuery est utilisé pour fournir des paramètres de requête à une RouteModel. Plus....

• Liste de tous les membres, y compris les membres hérités

Propriétés

• departureTime : date
• excludedAreas : list<geoRectangle>
• featureTypes : QList<FeatureType>
• maneuverDetail : enumeration
• numberAlternativeRoutes : int
• routeOptimizations : enumeration
• segmentDetail : enumeration
• travelModes : enumeration
• waypoints : list<coordinate>

Méthodes

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

Description détaillée

Une RouteQuery est utilisée pour rassembler tous les paramètres nécessaires pour faire une demande à un service de routage, qui peut ensuite remplir le contenu d'un RouteModel.

Ces paramètres décrivent les détails clés de l'itinéraire, tels que waypoints à traverser, excludedAreas à éviter, travelModes en cours d'utilisation, ainsi que des préférences détaillées sur la manière d'optimiser l'itinéraire et les caractéristiques à privilégier ou à éviter le long du chemin (telles que les routes à péage, les autoroutes, etc.).

Les objets RouteQuery sont utilisés exclusivement pour renseigner la valeur de la propriété RouteModel's query, qui peut alors commencer le processus d'extraction pour alimenter le modèle.

Certains plugins peuvent autoriser ou exiger des paramètres spécifiques pour fonctionner. Afin de spécifier ces paramètres spécifiques au plugin, les éléments MapParameter peuvent être imbriqués à l'intérieur d'un RouteQuery.

Exemple d'utilisation

L'extrait suivant montre un exemple incomplet de création d'un objet RouteQuery et de son utilisation comme valeur de la propriété RouteModel's query.

RouteQuery {
    id: aQuery
}

RouteModel {
    query: aQuery
    autoUpdate: false
}

Pour un exemple plus complet, voir la documentation sur le type RouteModel et l'exemple Mapviewer.

Voir également RouteModel.

Documentation sur les propriétés

departureTime : date

L'heure de départ à utiliser lors de la recherche de l'itinéraire. La valeur par défaut est une date non valide, ce qui signifie qu'aucune heure de départ ne sera utilisée dans la requête.

excludedAreas : list<geoRectangle>

Zones que l'itinéraire ne doit pas traverser.

Les zones exclues peuvent être définies dans le cadre de la déclaration du type RouteQuery ou dynamiquement à l'aide des fonctions fournies.

Voir également addExcludedArea, removeExcludedArea, et clearExcludedAreas.

featureTypes : QList<FeatureType> [read-only]

Liste des caractéristiques qui seront prises en compte lors de la planification de l'itinéraire. Les caractéristiques ayant un poids égal à NeutralFeatureWeight ne seront pas renvoyées.

• RouteQuery.NoFeature - Aucune caractéristique ne sera prise en compte lors de la planification de l'itinéraire.
• RouteQuery.TollFeature - Prendre en compte les péages lors de la planification de l'itinéraire
• RouteQuery.HighwayFeature - Prendre en compte les autoroutes lors de la planification de l'itinéraire
• RouteQuery.PublicTransitFeature - Prendre en compte les transports en commun lors de la planification de l'itinéraire
• RouteQuery.FerryFeature - Tenir compte des ferries lors de la planification de l'itinéraire
• RouteQuery.TunnelFeature - Tenir compte des tunnels lors de la planification de l'itinéraire
• RouteQuery.DirtRoadFeature - Tenir compte des chemins de terre lors de la planification de l'itinéraire
• RouteQuery.ParksFeature - Tenir compte des parcs lors de la planification de l'itinéraire
• RouteQuery.MotorPoolLaneFeature - Tenir compte des voies de garage lors de la planification de l'itinéraire
• RouteQuery.TrafficFeature - Tenir compte du trafic lors de la planification de l'itinéraire

Voir également setFeatureWeight et featureWeight.

maneuverDetail : enumeration

Le niveau de détail qui sera utilisé dans la représentation des manœuvres de routage.

La valeur par défaut est RouteQuery.BasicManeuvers.

numberAlternativeRoutes : int

Le nombre d'itinéraires alternatifs demandés lors de la demande d'itinéraires. La valeur par défaut est 0.

routeOptimizations : enumeration

Les optimisations de l'itinéraire qui doivent être prises en compte lors de la planification de l'itinéraire. Les valeurs peuvent être combinées avec l'opérateur OR ('|').

La valeur par défaut est RouteQuery.FastestRoute.

segmentDetail : enumeration

Le niveau de détail qui sera utilisé dans la représentation des segments de routage.

La valeur par défaut est RouteQuery.BasicSegmentData.

travelModes : enumeration

Les modes de transport à prendre en compte lors de la planification de l'itinéraire. Les valeurs peuvent être combinées avec l'opérateur OR ('|').

La valeur par défaut est RouteQuery.CarTravel.

waypoints : list<coordinate>

Les coordonnées des points de passage de l'itinéraire souhaité. Les points de passage doivent être indiqués dans l'ordre, de l'origine à la destination. Deux coordonnées ou plus sont nécessaires.

Les points de passage peuvent être définis dans le cadre de la déclaration du type RouteQuery ou dynamiquement à l'aide des fonctions fournies.

Voir également addWaypoint, removeWaypoint, et clearWaypoints.

Documentation de la méthode

void addExcludedArea(geoRectangle area)

Ajoute le site geoRectangle area spécifié aux zones exclues (zones que l'itinéraire ne doit pas traverser). Une même zone ne peut être ajoutée qu'une seule fois.

Voir également removeExcludedArea et clearExcludedAreas.

void addWaypoint(coordinate)

Ajoute le site coordinate à la liste des points de passage. La même coordonnée peut être définie plusieurs fois.

Voir également removeWaypoint et clearWaypoints.

void clearExcludedAreas()

Efface toutes les zones exclues (zones que l'itinéraire ne doit pas traverser).

Voir également addExcludedArea et removeExcludedArea.

void clearWaypoints()

Efface tous les waypoints.

Voir également removeWaypoint et addWaypoint.

FeatureWeight featureWeight(FeatureType featureType)

Obtient le poids de l'article featureType.

Voir aussi featureTypes, setFeatureWeight, et resetFeatureWeights.

void removeExcludedArea(geoRectangle area)

Supprime le site area des zones exclues (zones que l'itinéraire ne doit pas traverser).

Voir également addExcludedArea et clearExcludedAreas.

void removeWaypoint(coordinate)

Supprime le site coordinate de la liste des points de passage. Si la même coordonnée apparaît plusieurs fois, l'instance de coordonnées la plus récemment ajoutée est supprimée.

Voir également addWaypoint et clearWaypoints.

void resetFeatureWeights()

Réinitialise tous les poids des caractéristiques à leur état par défaut (NeutralFeatureWeight).

Voir aussi featureTypes, setFeatureWeight, et featureWeight.

void setFeatureWeight(FeatureType feature, FeatureWeight weight)

Définit le site weight à associer à un site feature lors de la planification d'un itinéraire.

La liste suivante énumère les poids possibles des caractéristiques :

Voir également featureTypes, resetFeatureWeights, et featureWeight.