route QML Value Type

Der Routentyp steht für eine geografische Route. Mehr...

Eigenschaften

• bounds : geoRectangle
• distance : real
• extendedAttributes : Object (since QtLocation 5.13)
• legIndex : int
• legs : list<route> (since QtLocation 5.12)
• overallRoute : Route
• path : list<coordinate>
• segments : list<routeSegment>
• travelTime : int

Methoden

• int segmentsCount()

Ausführliche Beschreibung

Ein Routentyp enthält allgemeine Informationen zu einer Route, wie beispielsweise die Länge der Route, die geschätzte Fahrzeit für die Route sowie ausreichende Informationen, um eine einfache Darstellung der Route auf einer Karte zu ermöglichen.

Das Objekt „ QGeoRoute “ enthält außerdem eine Liste von „ routeSegment “-Objekten, die Teilabschnitte der Route detaillierter beschreiben.

Das wichtigste Mittel zum Abrufen von Routenobjekten ist „ RouteModel “.

Beispiel

Dieses Beispiel zeigt, wie die Manöver einer Route in einem „ ListView “ angezeigt werden:

import QtQuick
import QtPositioning
import QtLocation

RouteModel {
    id: routeModel
    // model initialization
}

ListView {
    id: listview
    anchors.fill: parent
    spacing: 10
    model: routeModel.status == RouteModel.Ready ? routeModel.get(0).segments : null
    visible: model ? true : false
    delegate: Row {
        width: parent.width
        spacing: 10
        property bool hasManeuver : modelData.maneuver && modelData.maneuver.valid
        visible: hasManeuver
        Text { text: (1 + index) + "." }
        Text { text: hasManeuver ? modelData.maneuver.instructionText : "" }
    }
}

Dokumentation zu den Eigenschaften

bounds : geoRectangle

Schreibgeschützte Eigenschaft, die einen Begrenzungsrahmen enthält, der die gesamte Route umfasst.

distance : real

Schreibgeschützte Eigenschaft, die die von dieser Route zurückgelegte Strecke in Metern angibt.

extendedAttributes : Object [since QtLocation 5.13]

Diese Eigenschaft enthält die erweiterten Attribute der Route und ist ein Map-Objekt. Diese Attribute sind plugin-spezifisch und können leer sein.

In der Plugin-Dokumentation erfahren Sie, welche Attribute unterstützt werden und wie sie verwendet werden sollten.

Beachten Sie, dass es aufgrund von Einschränkungen des „ QQmlPropertyMap “ nicht möglich ist, die Attribute in QML deklarativ anzugeben; die Zuweisung von Attributschlüsseln und -werten kann nur über JavaScript erfolgen.

Diese Eigenschaft wurde in QtLocation 5.13 eingeführt.

legIndex : int

Schreibgeschützte Eigenschaft, die den Index des Abschnitts innerhalb der Liste der QtLocation::route::legs der übergeordneten Route enthält. Der Index ist -1, wenn diese Route kein Abschnitt einer übergeordneten Route ist.

Siehe auch „ overallRoute “.

legs : list<route> [since QtLocation 5.12]

Gibt die zu dieser Route gehörenden Routenabschnitte zurück. Routenabschnitte sind die Teilstrecken zwischen jeweils zwei benachbarten Wegpunkten. Das Ergebnis kann leer sein, wenn diese Detailebene vom Backend nicht unterstützt wird.

Diese Eigenschaft wurde in QtLocation 5.12 eingeführt.

overallRoute : Route

Schreibgeschützte Eigenschaft, die die Route enthält, zu der dieser Abschnitt gehört.

path : list<coordinate>

Schreibgeschützte Eigenschaft, die die geografischen Koordinaten dieser Route enthält. Die Koordinaten sind in der Reihenfolge aufgeführt, in der sie von einer Person durchlaufen würden, die diesen Streckenabschnitt zurücklegt.

Um auf einzelne Segmente zuzugreifen, können Sie die üblichen Listenzugriffsfunktionen verwenden: „path.length“ gibt die Anzahl der Objekte an und „path[Index beginnend bei Null]“ liefert das jeweilige Objekt.

Siehe auch QtPositioning::coordinate.

segments : list<routeSegment>

Schreibgeschützte Eigenschaft, die die Liste der „ routeSegment “-Objekte dieser Route enthält.

Um auf einzelne Segmente zuzugreifen, können Sie die üblichen Listenzugriffsmethoden verwenden: „segments.length“ gibt die Anzahl der Objekte an und „segments[Index beginnend bei Null]“ liefert die eigentlichen Objekte.

Siehe auch „ routeSegment “.

travelTime : int

Schreibgeschützte Eigenschaft, die die geschätzte Zeit in Sekunden angibt, die für die Bewältigung dieser Route benötigt wird.

Methodendokumentation

int segmentsCount()

Gibt die Anzahl der Segmente auf der Route zurück

Siehe auch routeSegment.