routeManeuver QML Type

routeManeuver 类型表示两个航段交汇点的相关信息。更多

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

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

属性

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

该属性包含与该操作相关的航点。并非所有机动都有相关的航点。

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