routeManeuver QML Type

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

• 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, die mit dem Anweisungstext verbunden ist, der mit einer routeManeuver verknüpft ist.

• RouteManeuver.NoDirection - Mit dem Anweisungstext ist keine Fahrtrichtung verbunden.
• 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 die instructionText angezeigt werden soll.

timeToNextInstruction : int

Diese schreibgeschützte Eigenschaft enthält die geschätzte Zeit in Sekunden, die von dem Punkt, an dem die zugehörige Anweisung erteilt wurde, bis zu dem Punkt, an dem die nächste Anweisung erteilt werden sollte, vergehen wird.

valid : bool

Diese schreibgeschützte Eigenschaft gibt an, ob dieses 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.