RouteQuery QML Type

Der Typ „RouteQuery“ wird verwendet, um Abfrageparameter an eine „ RouteModel “ zu übergeben. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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)

Ausführliche Beschreibung

Ein `RouteQuery`-Objekt dient dazu, alle Parameter zusammenzufassen, die für eine Anfrage an einen Routing-Dienst erforderlich sind, der daraufhin den Inhalt eines ` RouteModel`-Objekts füllen kann.

Diese Parameter beschreiben wichtige Details der Route, wie z. B. die zu durchfahrenden „ waypoints “, die zu meidenden „ excludedAreas “, die verwendete „ travelModes “ sowie detaillierte Präferenzen zur Optimierung der Route und dazu, welche Merkmale entlang der Strecke bevorzugt oder vermieden werden sollen (z. B. mautpflichtige Straßen, Autobahnen usw.).

RouteQuery-Objekte dienen ausschließlich dazu, den Wert der Eigenschaft „ query “ eines „ RouteModel “-Objekts zu füllen, wodurch anschließend der Abrufvorgang zur Befüllung des Modells gestartet werden kann.

Einige Plugins erfordern möglicherweise bestimmte Parameter für den Betrieb oder lassen diese zu. Um diese pluginspezifischen Parameter anzugeben, können „MapParameter“-Elemente innerhalb eines „RouteQuery“-Objekts verschachtelt werden.

Anwendungsbeispiel

Der folgende Codeausschnitt zeigt ein unvollständiges Beispiel für die Erstellung eines „RouteQuery“-Objekts und dessen Zuweisung als Wert der Eigenschaft „ query “ eines „ RouteModel “.

RouteQuery {
    id: aQuery
}

RouteModel {
    query: aQuery
    autoUpdate: false
}

Ein ausführlicheres Beispiel finden Sie in der Dokumentation zum Typ „ RouteModel “ sowie im Beispiel „Mapviewer“.

Siehe auch „ RouteModel “.

Eigenschaftsdokumentation

departureTime : date

Die Abfahrtszeit, die bei der Abfrage der Route verwendet werden soll. Der Standardwert ist ein ungültiges Datum, was bedeutet, dass bei der Abfrage keine Abfahrtszeit verwendet wird.

excludedAreas : list<geoRectangle>

Bereiche, die die Route nicht durchqueren darf.

Ausgeschlossene Bereiche können im Rahmen der Typdeklaration „ RouteQuery “ oder dynamisch mit den bereitgestellten Funktionen festgelegt werden.

Siehe auch „ addExcludedArea “, „ removeExcludedArea “ und „ clearExcludedAreas “.

featureTypes : QList<FeatureType> [read-only]

Liste der Merkmale, die bei der Routenplanung berücksichtigt werden. Merkmale mit der Gewichtung „NeutralFeatureWeight“ werden nicht zurückgegeben.

• RouteQuery.NoFeature – Bei der Routenplanung werden keine Merkmale berücksichtigt
• RouteQuery.TollFeature – Mautstraßen werden bei der Routenplanung berücksichtigt
• RouteQuery.HighwayFeature – Autobahnen bei der Routenplanung berücksichtigen
• RouteQuery.PublicTransitFeature – Öffentliche Verkehrsmittel bei der Routenplanung berücksichtigen
• RouteQuery.FerryFeature – Fähren bei der Routenplanung berücksichtigen
• RouteQuery.TunnelFeature – Bei der Routenplanung werden Tunnel berücksichtigt
• RouteQuery.DirtRoadFeature – Unbefestigte Straßen bei der Routenplanung berücksichtigen
• RouteQuery.ParksFeature – Berücksichtigen Sie Parks bei der Routenplanung
• RouteQuery.MotorPoolLaneFeature – Berücksichtigen Sie Fahrspuren für Fahrgemeinschaften bei der Routenplanung
• RouteQuery.TrafficFeature – Berücksichtigen Sie den Verkehr bei der Routenplanung

Siehe auch setFeatureWeight und featureWeight.

maneuverDetail : enumeration

Der Detaillierungsgrad, der bei der Darstellung von Routing-Manövern verwendet wird.

Der Standardwert lautet „ RouteQuery.BasicManeuvers “.

numberAlternativeRoutes : int

Die Anzahl der alternativen Routen, die bei der Routenanfrage angefordert werden sollen. Der Standardwert ist 0.

routeOptimizations : enumeration

Die Routenoptimierungen, die bei der Routenplanung berücksichtigt werden sollten. Werte können mit dem OR-Operator („|“) kombiniert werden.

Der Standardwert lautet „ RouteQuery.FastestRoute “.

segmentDetail : enumeration

Der Detaillierungsgrad, der bei der Darstellung von Routing-Segmenten verwendet wird.

Der Standardwert lautet „ RouteQuery.BasicSegmentData “.

travelModes : enumeration

Die Verkehrsmittel, die bei der Routenplanung berücksichtigt werden sollten. Die Werte können mit dem OR-Operator („|“) kombiniert werden.

Der Standardwert lautet „ RouteQuery.CarTravel “.

waypoints : list<coordinate>

Die Koordinaten der Wegpunkte für die gewünschte Route. Die Wegpunkte sollten in der Reihenfolge vom Startpunkt zum Zielpunkt angegeben werden. Es sind zwei oder mehr Koordinaten erforderlich.

Wegpunkte können im Rahmen der Typdeklaration „ RouteQuery “ oder dynamisch mit den bereitgestellten Funktionen festgelegt werden.

Siehe auch „ addWaypoint “, „ removeWaypoint “ und „ clearWaypoints “.

Methodendokumentation

void addExcludedArea(geoRectangle area)

Fügt die angegebenen geoRectangle area zu den ausgeschlossenen Gebieten hinzu (Gebiete, die die Route nicht durchqueren darf). Ein und dasselbe Gebiet kann nur einmal hinzugefügt werden.

Siehe auch „ removeExcludedArea “ und „ clearExcludedAreas “.

void addWaypoint(coordinate)

Fügt die angegebene Koordinatenangabe „ coordinate “ zur Liste der Wegpunkte hinzu. Dieselbe Koordinate kann mehrfach festgelegt 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)

Ruft das Gewicht für „ featureType “ ab.

Siehe auch „ featureTypes “, „ setFeatureWeight “ und „ resetFeatureWeights “.

void removeExcludedArea(geoRectangle area)

Entfernt die angegebene „ area “ aus den ausgeschlossenen Bereichen (Bereiche, die die Route nicht durchqueren darf).

Siehe auch „ addExcludedArea “ und „ clearExcludedAreas “.

void removeWaypoint(coordinate)

Entfernt die angegebene Koordinate „ coordinate “ aus der Liste der Wegpunkte. Wenn dieselbe Koordinate mehrfach vorkommt, wird die zuletzt hinzugefügte Instanz dieser Koordinate entfernt.

Siehe auch „ addWaypoint “ und „ clearWaypoints “.

void resetFeatureWeights()

Setzt alle Merkmalsgewichte auf ihren Standardwert (NeutralFeatureWeight) zurück.

Siehe auch featureTypes, setFeatureWeight und featureWeight.

void setFeatureWeight(FeatureType feature, FeatureWeight weight)

Legt die „ weight “ fest, die bei der Routenplanung mit einem „ feature “ verknüpft werden soll.

Im Folgenden sind die möglichen Gewichte der Merkmale aufgeführt:

Siehe auch featureTypes, resetFeatureWeights und featureWeight.