routeManeuver QML Type

Der Typ routeManeuver stellt die Informationen dar, die für den Punkt relevant sind, an dem sich zwei routeSegmente treffen. Mehr...

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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

direction : enumeration
distanceToNextInstruction : real
extendedAttributes : Object (since QtLocation 5.11)
instructionText : string
position : coordinate
timeToNextInstruction : int
valid : bool
waypoint : coordinate

Detaillierte Beschreibung

Instanzen von routeSegment kann man sich als Kanten in einem Routing-Graphen vorstellen, wobei routeManeuver-Instanzen als optionale Beschriftungen an den Eckpunkten des Graphen angebracht sind.

Die interessantesten Informationen, die in einer routeManeuver-Instanz enthalten sind, sind normalerweise die zu liefernde textuelle Navigation und die Position, an der sie geliefert werden soll, zugänglich durch instructionText bzw. position.

Beispiel

Das folgende QML-Snippet demonstriert, wie man Informationen über ein Routenmanöver ausgibt:

import QtQuick
import QtPositioning
import QtLocation

Text {
    text: "Distance till next maneuver: " + routeManeuver.distanceToNextInstruction
          + " meters, estimated time: " + routeManeuver.timeToNextInstruction + " seconds."
}

Eigenschaft Dokumentation

direction : enumeration

Beschreibt die Richtungsänderung in Verbindung mit dem Anweisungstext, der mit einem routeManeuver verbunden ist.

RouteManeuver.NoDirection - Dem Anweisungstext ist keine Richtung zugeordnet
RouteManeuver.DirectionForward - Die Anweisung zeigt an, dass die Fahrtrichtung nicht geändert werden muss
RouteManeuver.DirectionBearRight - Die Anweisung zeigt an, dass die Fahrtrichtung nach rechts gerichtet werden soll.
RouteManeuver.DirectionLightRight - Die Anweisung zeigt an, dass ein leichtes Abbiegen nach rechts erforderlich ist
RouteManeuver.DirectionRight - Die Anweisung zeigt an, dass ein Abbiegen nach rechts erforderlich ist.
RouteManeuver.DirectionHardRight - Die Anweisung zeigt an, dass eine scharfe Abbiegung nach rechts erforderlich ist.
RouteManeuver.DirectionUTurnRight - Die Anweisung zeigt an, dass ein U-Turn nach rechts erforderlich ist
RouteManeuver.DirectionUTurnLeft - Die Anweisung zeigt an, dass ein U-Turn nach links erforderlich ist.
RouteManeuver.DirectionHardLeft - Die Anweisung zeigt an, dass ein hartes Abbiegen nach links erforderlich ist.
RouteManeuver.DirectionLeft - Die Anweisung zeigt an, dass ein Abbiegen nach links erforderlich ist.
RouteManeuver.DirectionLightLeft - Die Anweisung zeigt an, dass ein leichtes Abbiegen nach links erforderlich ist.
RouteManeuver.DirectionBearLeft - Die Anweisung zeigt an, dass die Fahrtrichtung nach links gerichtet werden soll.

distanceToNextInstruction : real

Diese schreibgeschützte Eigenschaft enthält die Entfernung in Metern zwischen dem Punkt, an dem die zugehörige Anweisung erteilt wurde, und dem Punkt, an dem die nächste Anweisung erteilt werden sollte.

extendedAttributes : Object [since QtLocation 5.11]

Diese Eigenschaft enthält die erweiterten Attribute des Manövers 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.11 eingeführt.

instructionText : string

Diese schreibgeschützte Eigenschaft enthält textuelle Navigationsanweisungen.

position : coordinate

Diese schreibgeschützte Eigenschaft gibt an, wo instructionText angezeigt werden soll.

timeToNextInstruction : int

Diese schreibgeschützte Eigenschaft enthält die geschätzte Zeit in Sekunden, die für die Fahrt von dem Punkt, an dem die zugehörige Anweisung erteilt wurde, bis zu dem Punkt, an dem die nächste Anweisung erteilt werden soll, benötigt wird.

valid : bool

Diese Nur-Lese-Eigenschaft gibt an, ob das Manöver gültig ist oder nicht.

Ungültige Manöver werden verwendet, wenn es keine Informationen gibt, die mit dem Endpunkt einer QGeoRouteSegment Instanz verbunden werden müssen.

waypoint : coordinate

Diese Eigenschaft enthält den mit diesem Manöver verbundenen Wegpunkt. Nicht alle Manöver haben einen Wegpunkt, der mit ihnen verbunden ist.

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