routeManeuver QML Type

“routeManeuver”类型表示与两个“routeSegment”交汇点相关的信息。更多内容...

• 所有成员列表（包括继承的成员）

属性

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

详细说明

routeSegment 的实例可以视为路由图上的边，而 routeManeuver 实例则是附加在图的顶点上的可选标签。

routeManeuver 实例中包含的最有价值的信息通常是需要提供的导航文本以及提供该文本的位置，分别可通过instructionText 和position 访问。

示例

以下 QML 代码片段演示了如何打印有关路线操作的信息：

import QtQuick
import QtPositioning
import QtLocation

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

属性文档

direction : enumeration

描述与routeManeuver 关联的指令文本所对应的方向变化。

• RouteManeuver.NoDirection - 该指令文本未关联任何方向
• RouteManeuver.DirectionForward - 该指示表明行进方向无需改变
• RouteManeuver.DirectionBearRight - 该指令表示行驶方向应向右偏移
• RouteManeuver.DirectionLightRight - 该指令表示需要轻微向右转弯
• RouteManeuver.DirectionRight - 该指令表示需要向右转弯
• RouteManeuver.DirectionHardRight - 该指令表示需要向右急转
• RouteManeuver.DirectionUTurnRight - 该指令表示需要向右掉头
• RouteManeuver.DirectionUTurnLeft - 该指令表示需要向左掉头
• RouteManeuver.DirectionHardLeft - 该指令表示需要向左急转弯
• RouteManeuver.DirectionLeft - 该指令表示需要向左转弯
• RouteManeuver.DirectionLightLeft - 该指令表示需要轻微向左转弯
• RouteManeuver.DirectionBearLeft - 该指令表示行驶方向应向左偏移

distanceToNextInstruction : real

此只读属性存储了相关指令发出点与应发出下一条指令的点之间的距离（单位为米）。

extendedAttributes : Object [since QtLocation 5.11]

该属性存储了该机动动作的扩展属性，类型为映射。这些属性因插件而异，且可以为空。

有关支持哪些属性以及如何使用它们，请参阅插件文档。

请注意，由于QQmlPropertyMap 的限制，无法在QML中声明式地指定这些属性，属性的键值对只能通过JavaScript进行赋值。

该属性在 QtLocation 5.11 中引入。

instructionText : string

此只读属性包含文本导航说明。

position : coordinate

此只读属性用于指定instructionText 应显示的位置。

timeToNextInstruction : int

此只读属性存储从发出相关指令的点到应发出下一条指令的点所需的时间（以秒为单位）。

valid : bool

此只读属性用于标识该机动是否有效。

当无需将任何信息附加到QGeoRouteSegment 实例的端点时，会使用无效操作。

waypoint : coordinate

该属性存储与该机动操作相关联的航点。并非所有机动操作都关联有航点。