routeManeuver QML Type

Der Typ „routeManeuver“ stellt die Informationen dar, die für den Schnittpunkt zweier „routeSegments“ relevant sind. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

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

Ausführliche Beschreibung

Instanzen von ` routeSegment ` können als Kanten in einem Routing-Graphen betrachtet werden, wobei `routeManeuver`-Instanzen als optionale Beschriftungen an den Knoten des Graphen angehängt sind.

Die interessantesten Informationen, die eine „routeManeuver“-Instanz enthält, sind in der Regel der anzuzeigende Navigationstext und die Position, an der dieser angezeigt werden soll; auf diese kann über „ instructionText “ bzw. „ position “ zugegriffen werden.

Beispiel

Der folgende QML-Ausschnitt zeigt, wie Informationen zu einem Routenmanöver ausgegeben werden können:

import QtQuick
import QtPositioning
import QtLocation

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

Dokumentation der Eigenschaften

direction : enumeration

Beschreibt die Richtungsänderung, die mit dem Anweisungstext verbunden ist, der einem „ routeManeuver “ zugeordnet ist.

• RouteManeuver.NoDirection – Dem Anweisungstext ist keine Richtung zugeordnet
• RouteManeuver.DirectionForward – Die Anweisung besagt, dass die Fahrtrichtung nicht geändert werden muss
• RouteManeuver.DirectionBearRight – Die Anweisung besagt, dass die Fahrtrichtung nach rechts abfallen soll
• RouteManeuver.DirectionLightRight – Die Anweisung besagt, dass eine leichte Rechtskurve erforderlich ist
• RouteManeuver.DirectionRight – Die Anweisung besagt, dass eine Rechtskurve erforderlich ist
• RouteManeuver.DirectionHardRight – Die Anweisung besagt, dass eine scharfe Rechtskurve erforderlich ist
• RouteManeuver.DirectionUTurnRight – Die Anweisung besagt, dass eine Wende nach rechts erforderlich ist
• RouteManeuver.DirectionUTurnLeft – Die Anweisung besagt, dass eine Kehrtwende nach links erforderlich ist
• RouteManeuver.DirectionHardLeft – Die Anweisung gibt an, dass eine scharfe Linkskurve erforderlich ist
• RouteManeuver.DirectionLeft – Die Anweisung besagt, dass eine Linkskurve erforderlich ist
• RouteManeuver.DirectionLightLeft – Die Anweisung besagt, dass eine leichte Linkskurve erforderlich ist
• RouteManeuver.DirectionBearLeft – Die Anweisung besagt, dass die Fahrtrichtung nach links tendieren soll

distanceToNextInstruction : real

Diese schreibgeschützte Eigenschaft gibt den Abstand in Metern zwischen dem Punkt, an dem der zugehörige Befehl erteilt wurde, und dem Punkt an, an dem der nächste Befehl erteilt werden soll, an.

extendedAttributes : Object [since QtLocation 5.11]

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

instructionText : string

Diese schreibgeschützte Eigenschaft enthält textuelle Navigationsanweisungen.

position : coordinate

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

timeToNextInstruction : int

Diese schreibgeschützte Eigenschaft enthält die geschätzte Zeit in Sekunden, die benötigt wird, um von dem Zeitpunkt, zu dem der zugehörige Befehl ausgegeben wurde, bis zu dem Zeitpunkt zu gelangen, zu dem der nächste Befehl ausgegeben werden soll.

valid : bool

Diese schreibgeschützte Eigenschaft gibt an, ob dieses Manöver gültig ist oder nicht.

Ungültige Manöver werden verwendet, wenn keine Informationen vorhanden sind, die an den Endpunkt einer ` QGeoRouteSegment `-Instanz angehängt werden müssen.

waypoint : coordinate

Diese Eigenschaft enthält den Wegpunkt, der diesem Manöver zugeordnet ist. Nicht allen Manövern ist ein Wegpunkt zugeordnet.