RouteQuery QML Type
Der Typ RouteQuery wird verwendet, um Abfrageparameter für eine RouteModel bereitzustellen. Mehr...
| Import Statement: | import QtLocation 6.8 |
| Since: | QtLocation 5.5 |
Eigenschaften
- departureTime : date
- excludedAreas : list<georectangle>
- featureTypes : QList<FeatureType>
- maneuverDetail : enumeration
- numberAlternativeRoutes : int
- routeOptimizations : enumeration
- segmentDetail : enumeration
- travelModes : enumeration
- waypoints : list<coordinate>
Methoden
- 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)
Detaillierte Beschreibung
Eine RouteQuery wird verwendet, um alle Parameter zu packen, die notwendig sind, um eine Anfrage an einen Routing-Dienst zu stellen, der dann den Inhalt einer RouteModel auffüllen kann.
Diese Parameter beschreiben wichtige Details der Route, z. B. waypoints, die zu durchfahren sind, excludedAreas, die zu vermeiden sind, die travelModes, die verwendet werden, sowie detaillierte Präferenzen, wie die Route zu optimieren ist und welche Merkmale entlang des Weges zu bevorzugen oder zu vermeiden sind (z. B. Mautstraßen, Autobahnen usw.).
RouteQuery-Objekte werden ausschließlich dazu verwendet, den Wert der Eigenschaft query von RouteModel auszufüllen, die dann den Abrufprozess zum Auffüllen des Modells starten kann.
Einige Plugins können bestimmte Parameter zulassen oder erfordern, um zu funktionieren. Um diese Plugin-spezifischen Parameter zu spezifizieren, können MapParameter-Elemente innerhalb einer RouteQuery verschachtelt werden.
Beispielverwendung
Der folgende Ausschnitt zeigt ein unvollständiges Beispiel für die Erstellung eines RouteQuery-Objekts und dessen Verwendung als Wert für die query -Eigenschaft eines RouteModel.
RouteQuery {
id: aQuery
}
RouteModel {
query: aQuery
autoUpdate: false
}Ein vollständigeres Beispiel finden Sie in der Dokumentation für den Typ RouteModel und im Mapviewer-Beispiel.
Siehe auch RouteModel.
Dokumentation der Eigenschaft
departureTime : date |
Die Abfahrtszeit, die bei der Abfrage der Route verwendet werden soll. Der Standardwert ist ein ungültiges Datum, d. h. es wird keine Abfahrtszeit in der Abfrage verwendet.
excludedAreas : list<georectangle> |
Gebiete, die die Route nicht durchqueren darf.
Ausgeschlossene Gebiete können als Teil der RouteQuery Typdeklaration oder dynamisch mit den bereitgestellten Funktionen festgelegt werden.
Siehe auch addExcludedArea, removeExcludedArea, und clearExcludedAreas.
featureTypes : QList<FeatureType> |
Liste der Merkmale, die bei der Planung der Route berücksichtigt werden sollen. Merkmale mit einem Gewicht von NeutralFeatureWeight werden nicht zurückgegeben.
- RouteQuery.NoFeature - Bei der Planung der Route werden keine Merkmale berücksichtigt.
- RouteQuery.TollFeature - Mautstraßen werden bei der Planung der Route berücksichtigt
- RouteQuery.HighwayFeature - Berücksichtigt Autobahnen bei der Planung der Route
- RouteQuery.PublicTransitFeature - Öffentliche Verkehrsmittel werden bei der Planung der Route berücksichtigt
- RouteQuery.FerryFeature - Berücksichtigen Sie Fähren bei der Planung der Route
- RouteQuery.TunnelFeature - Berücksichtigt Tunnel bei der Routenplanung
- RouteQuery.DirtRoadFeature - Berücksichtigt unbefestigte Straßen bei der Routenplanung
- RouteQuery.ParksFeature - Berücksichtigt Parks bei der Planung der Route
- RouteQuery.MotorPoolLaneFeature - Berücksichtigen Sie bei der Routenplanung Schwimmbadspuren
- RouteQuery.TrafficFeature - Berücksichtigt den Verkehr bei der Planung der Route
Siehe auch setFeatureWeight und featureWeight.
maneuverDetail : enumeration |
Der Detaillierungsgrad, der bei der Darstellung von Routingmanövern verwendet wird.
| Konstante | Beschreibung |
|---|---|
RouteQuery.NoManeuvers | Es sollen keine Manöver in die Route aufgenommen werden |
RouteQuery.BasicManeuvers | Grundlegende Manöver werden in die Route aufgenommen |
Der Standardwert ist RouteQuery.BasicManeuvers.
numberAlternativeRoutes : int |
Die Anzahl der alternativen Routen, die bei der Anforderung von Routen angefordert werden. Der Standardwert ist 0.
routeOptimizations : enumeration |
Die Routenoptimierungen, die bei der Planung der Route berücksichtigt werden sollen. Die Werte können mit dem OR ('|')-Operator kombiniert werden.
| Konstante | Beschreibung |
|---|---|
RouteQuery.ShortestRoute | Minimiere die Länge der Fahrt |
RouteQuery.FastestRoute | Minimierung der Fahrtzeit für die Strecke |
RouteQuery.MostEconomicRoute | Minimiere die Kosten der Reise |
RouteQuery.MostScenicRoute | Maximierung des landschaftlichen Potentials der Reise |
Der Standardwert ist RouteQuery.FastestRoute.
segmentDetail : enumeration |
Der Detaillierungsgrad, der bei der Darstellung von Routing-Segmenten verwendet werden soll.
| Konstante | Beschreibung |
|---|---|
RouteQuery.NoSegmentData | Es sollen keine Segmentdaten in die Route aufgenommen werden |
RouteQuery.BasicSegmentData | Grundlegende Segmentdaten werden in die Route aufgenommen |
Der Standardwert ist RouteQuery.BasicSegmentData.
travelModes : enumeration |
Die Reisearten, die bei der Planung der Route berücksichtigt werden sollen. Die Werte können mit dem OR ('|')-Operator kombiniert werden.
| Konstante | Beschreibung |
|---|---|
RouteQuery.CarTravel | Die Route wird für jemanden optimiert, der ein Auto fährt |
RouteQuery.PedestrianTravel | Die Route wird für eine Person optimiert, die zu Fuß geht |
RouteQuery.BicycleTravel | Die Route wird für jemanden optimiert, der mit dem Fahrrad unterwegs ist. |
RouteQuery.PublicTransit | Reise Die Route wird für jemanden optimiert, der den öffentlichen Nahverkehr nutzt |
RouteQuery.TruckTravel | Die Route wird für jemanden optimiert, der mit einem LKW fährt |
Der Standardwert ist RouteQuery.CarTravel.
waypoints : list<coordinate> |
Die Koordinaten der Wegpunkte für die gewünschte Route. Die Wegpunkte sollten in der Reihenfolge vom Start zum Ziel angegeben werden. Es werden zwei oder mehr Koordinaten benötigt.
Wegpunkte können als Teil der Deklaration des Typs RouteQuery oder dynamisch mit den bereitgestellten Funktionen gesetzt werden.
Siehe auch addWaypoint, removeWaypoint, und clearWaypoints.
Methode Dokumentation
void addExcludedArea(georectangle area) |
Fügt das angegebene Geodreieck area zu den ausgeschlossenen Gebieten hinzu (Gebiete, die die Route nicht durchqueren darf). Das gleiche Gebiet kann nur einmal hinzugefügt werden.
Siehe auch removeExcludedArea und clearExcludedAreas.
void addWaypoint(coordinate) |
Hängt den angegebenen coordinate an die Liste der Wegpunkte an. Die gleiche Koordinate kann mehrfach gesetzt werden.
Siehe auch removeWaypoint und clearWaypoints.
void clearExcludedAreas() |
Löscht alle ausgeschlossenen Bereiche (Bereiche, die die Route nicht durchqueren darf).
Siehe auch addExcludedArea und removeExcludedArea.
void clearWaypoints() |
Löscht alle Wegpunkte.
Siehe auch removeWaypoint und addWaypoint.
FeatureWeight featureWeight(FeatureType featureType) |
Ermittelt die Gewichtung für die featureType.
Siehe auch featureTypes, setFeatureWeight, und resetFeatureWeights.
void removeExcludedArea(georectangle area) |
Entfernt die angegebene area aus ausgeschlossenen Gebieten (Gebiete, die die Route nicht durchqueren darf).
Siehe auch addExcludedArea und clearExcludedAreas.
void removeWaypoint(coordinate) |
Entfernt die angegebene coordinate aus der Liste der Wegpunkte. Wenn dieselbe Koordinate mehrfach vorkommt, wird die zuletzt hinzugefügte Koordinateninstanz entfernt.
Siehe auch addWaypoint und clearWaypoints.
void resetFeatureWeights() |
Setzt alle Feature-Gewichtungen auf ihren Standardzustand zurück (NeutralFeatureWeight).
Siehe auch featureTypes, setFeatureWeight, und featureWeight.
void setFeatureWeight(FeatureType feature, FeatureWeight weight) |
Definiert die weight, die bei der Planung einer Route mit einer feature verknüpft werden soll.
Im Folgenden werden die möglichen Merkmalsgewichtungen aufgelistet:
| Konstante | Beschreibung |
|---|---|
RouteQuery.NeutralFeatureWeight | Das Vorhandensein oder Nichtvorhandensein des Merkmals hat keinen Einfluss auf die Planung der Route |
RouteQuery.PreferFeatureWeight | Routen, die das Merkmal enthalten, werden gegenüber solchen, die es nicht enthalten, bevorzugt |
RouteQuery.RequireFeatureWeight | Nur Routen, die das Merkmal enthalten, werden berücksichtigt, ansonsten wird keine Route zurückgegeben |
RouteQuery.AvoidFeatureWeight | Routen, die das Merkmal nicht enthalten, werden gegenüber solchen bevorzugt, die es enthalten |
RouteQuery.DisallowFeatureWeight | Es werden nur Routen berücksichtigt, die das Merkmal nicht enthalten, andernfalls wird keine Route zurückgegeben. |
Siehe auch featureTypes, resetFeatureWeights, und featureWeight.
© 2025 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.
