route QML Value Type

Der Routentyp repräsentiert eine geografische Route. Mehr...

Import Statement:	`import QtLocation 6.8`
Since:	QtLocation 5.5

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

Detaillierte Beschreibung

Ein Routentyp enthält übergeordnete Informationen über eine Route, wie z. B. die Länge der Route, die geschätzte Reisezeit für die Route und genügend Informationen, um ein grundlegendes Bild der Route auf einer Karte darzustellen.

Das Objekt QGeoRoute enthält auch eine Liste von routeSegment Objekten, die Teilabschnitte der Route detaillierter beschreiben.

Das wichtigste Mittel zum Erwerb von Routenobjekten ist RouteModel.

Beispiel

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

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 : "" }
    }
}

Eigenschaft Dokumentation

bounds : georectangle

Nur-Lese-Eigenschaft, die einen Begrenzungsrahmen enthält, der die gesamte Route umschließt.

distance : real

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

extendedAttributes : Object [since QtLocation 5.13]

Diese Eigenschaft enthält die erweiterten Attribute der Route und ist eine Karte. Diese Attribute sind pluginspezifisch und können leer sein.

Lesen Sie in der Plugin-Dokumentation nach, welche Attribute unterstützt werden und wie sie verwendet werden sollten.

Beachten Sie, dass es aufgrund der Beschränkungen von QQmlPropertyMap nicht möglich ist, die Attribute deklarativ in QML zu spezifizieren; die Zuweisung von Attributschlüsseln und -werten kann nur durch JavaScript erfolgen.

Diese Eigenschaft wurde in QtLocation 5.13 eingeführt.

legIndex : int

Nur-Lese-Eigenschaft, die den Index der Strecke in der Liste der QtLocation::route::legs der enthaltenen Route enthält. Der Index ist -1, wenn diese Route keine Teilstrecke innerhalb einer Gesamtroute ist.

Siehe auch overallRoute.

legs : list<route> [since QtLocation 5.12]

Gibt die Streckenabschnitte zurück, die mit dieser Route verbunden sind. Routenabschnitte sind die Unterrouten zwischen jeweils zwei benachbarten Wegpunkten. Das Ergebnis kann leer sein, wenn diese Detailstufe vom Backend nicht unterstützt wird.

Diese Eigenschaft wurde in QtLocation 5.12 eingeführt.

overallRoute : Route

Nur-Lese-Eigenschaft, die die Route enthält, die diese Etappe beinhaltet.

path : list<coordinate>

Nur-Lese-Eigenschaft, die die geographischen Koordinaten dieser Route enthält. Die Koordinaten werden in der Reihenfolge aufgelistet, in der sie von jemandem durchquert würden, der entlang dieses Abschnitts der Route reist.

Um auf einzelne Segmente zuzugreifen, können Sie Standard-Listenzugriffsmethoden verwenden: 'path.length' gibt die Anzahl der Objekte an und 'path[index starting from zero]' gibt das eigentliche Objekt an.

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 Standard-Listen-Accessoren verwenden: 'segments.length' gibt die Anzahl der Objekte an und 'segments[index starting from zero]' gibt die eigentlichen Objekte an.

Siehe auch routeSegment.

travelTime : int

Nur-Lese-Eigenschaft, die die geschätzte Zeit für die Durchquerung dieser Route in Sekunden angibt.

Dokumentation der Methode

int segmentsCount()

Gibt die Anzahl der Segmente in der Route zurück.

Siehe auch routeSegment.

© 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.