route QML 值类型

route 类型表示一条地理路线。更多...

导入语句	import QtLocation 6.7
自	QtLocation 5.5

属性

bounds : georectangle
distance : real
extendedAttributes : Object (自 QtLocation 5.13)
legIndex : int
legs : list<route> (自 QtLocation 5.12)
overallRoute : Route
path : list<coordinate>
segments : list<routeSegment>
travelTime : int

方法

int segmentsCount()

详细描述

route 类型包含关于路线的高级信息，如路线长度、预计旅行时间以及在地图上渲染基本路线图像所需的信息。

QGeoRoute 对象还包含一个 routeSegment 对象列表，更详细地描述了路线的子部分。

获取路线对象的主要方式是 RouteModel。

示例

此示例演示了如何在 ListView 中显示路线的操纵。

import QtQuick
import QtPositioning
import QtLocation

RouteModel {
    id: routeModel
    // model initialization
}

ListView {
    id: listview
    anchors.fill: parent
    spacing: 10
    model: routeModel.status == RouteModel.Ready ? routeModel.get(0).segments : null
    visible: model ? true : false
    delegate: Row {
        width: parent.width
        spacing: 10
        property bool hasManeuver : modelData.maneuver && modelData.maneuver.valid
        visible: hasManeuver
        Text { text: (1 + index) + "." }
        Text { text: hasManeuver ? modelData.maneuver.instructionText : "" }
    }
}

属性文档

bounds : georectangle

只读属性，包含整个路线所包含的边界框。

distance : real

只读属性，包含此路线覆盖的距离（以米为单位）。

extendedAttributes : Object [since QtLocation 5.13]

此属性包含路线的扩展属性，是一个映射。这些属性是插件特定的，可以是空的。

请参阅插件文档，了解所支持的属性及其使用方式。

请注意，由于 QQmlPropertyMap 的限制，无法在 QML 中声明性指定属性，只能通过 JavaScript 分配属性键和值。

这个属性是在 QtLocation 5.13 中引入的。

legIndex : int

只读属性，用于存储包含该路线的QtLocation::route::legs列表中腿部索引。如果此路线不是整体路线的一部分，则索引为-1。

另请参阅overallRoute。

legs : list<route> [自QtLocation 5.12起]

返回与此路线关联的路线路径。路线路径是每个相邻航点之间的子路线。如果后端不支持此类细节，结果可能为空。

此属性自QtLocation 5.12版引入。

overallRoute : Route

只读属性，用于存储包含该腿部的路线。

path : list<coordinate>

只读属性，用于存储此路线的地理坐标。坐标按某人沿途开发利用的顺序列出。

要访问单个段，您可以使用标准列表访问器：'path.length' 表示对象的数量，而 '/path[index starting from zero]' 则提供实际对象。

另请参阅QtPositioning::coordinate。

segments : list<routeSegment>

只读属性，用于存储此路径的routeSegment对象列表。

要访问单个段，您可以使用标准列表访问器：'segments.length' 表示对象的数量，而 'segments[index starting from zero]' 则提供实际对象。

另请参阅routeSegment。

travelTime : int

只读属性，用于存储穿越此路线的估计时间，单位为秒。

方法文档

int segmentsCount()

返回路径中的段数

另请参阅routeSegment。