RouteQuery QML 类型

RouteQuery 类型用于向 RouteModel 提供查询参数。更多...

导入语句	import QtLocation 6.7
自	QtLocation 5.5

所有成员列表，包括继承的成员

属性

departureTime : 日期
excludedAreas : 地理矩形列表
featureTypes : 特征类型列表
maneuverDetail : 枚举
numberAlternativeRoutes : 整数
routeOptimizations : 枚举
segmentDetail : 枚举
travelModes : 枚举
waypoints : 坐标列表

方法

void addExcludedArea(georectangle area)
void addWaypoint(coordinate)
void clearExcludedAreas()
void clearWaypoints()
FeatureWeight featureWeight(FeatureType featureType)
void removeExcludedArea(georectangle area)
void removeWaypoint(coordinate)
void resetFeatureWeights()
void setFeatureWeight(FeatureType feature, FeatureWeight weight)

详细描述

RouteQuery 用于打包所有必要的参数，以向路由服务发起请求，然后填充 RouteModel 的内容。

这些参数描述了路线的关键详细信息，例如必须通过的 waypoints，要避免的 excludedAreas，正在使用的 travelModes，以及对如何优化路线以及首选或避免沿路径的特性（例如收费公路、高速公路等）的详细偏好。

RouteQuery对象专用于设置RouteModel的query属性值，进而开始检索过程以填充模型。

某些插件可能允许或要求特定的参数才能运行。为了指定这些特定的插件参数，可以在RouteQuery内部嵌套MapParameter元素。

示例使用

以下代码片段展示了创建RouteQuery对象并将其设置为RouteModel的query属性值的示例。

RouteQuery {
    id: aQuery
}

RouteModel {
    query: aQuery
    autoUpdate: false
}

要获取更完整的示例，请参阅RouteModel类型的文档和地图查看器示例。

另请参见RouteModel。

属性文档

departureTime : date

在查询路线时要使用的出发时间。默认值是无效日期，这意味着在查询中不会使用出发时间。

excludedAreas : list<georectangle>

路线必须不穿越的区域。

排除区域可以是RouteQuery类型声明的一部分，也可以通过提供的功能动态设置。

另请参见addExcludedArea、removeExcludedArea和clearExcludedAreas。

featureTypes : QList<FeatureType> [只读]

在规划路线时将考虑的功能列表。具有NeutralFeatureWeight权重的功能不会被返回。

RouteQuery.NoFeature - 在规划路线时不会考虑任何功能
RouteQuery.TollFeature - 在规划路线时考虑收费道路
RouteQuery.HighwayFeature - 在规划路线时考虑高速公路
RouteQuery.PublicTransitFeature - 在规划路线时考虑公共交通
RouteQuery.FerryFeature - 在规划路线时考虑渡轮
RouteQuery.TunnelFeature - 在规划路线时考虑隧道
RouteQuery.DirtRoadFeature - 在规划路线时考虑土路
RouteQuery.ParksFeature - 在规划路线时考虑公园
RouteQuery.MotorPoolLaneFeature - 在规划路线时考虑车辆停车场道
RouteQuery.TrafficFeature - 在规划路线时考虑交通状况

另请参见setFeatureWeight和featureWeight。

maneuverDetail : enumeration

用于表示路线操纵的详细程度。

常数	描述
`RouteQuery.NoManeuvers`	不应包含路线的操纵
`RouteQuery.BasicManeuvers`	应包含基本的操纵

默认值是RouteQuery.BasicManeuvers。

numberAlternativeRoutes : int

请求路线时请求的替代路线数量。默认值为0。

routeOptimizations : enumeration

在规划路线时应考虑的路线优化。值可以与 OR ('|') 运算符组合。

常数	描述
`RouteQuery.ShortestRoute`	最小化行程长度
`RouteQuery.FastestRoute`	最小化旅行时间
`RouteQuery.MostEconomicRoute`	最小化行程成本
`RouteQuery.MostScenicRoute`	最大化旅行的景观潜力

默认值是 RouteQuery.FastestRoute。

segmentDetail : 枚举

将在表示路由段中使用到的详细程度。

常数	描述
`RouteQuery.NoSegmentData`	路线中不应包含段数据
`RouteQuery.BasicSegmentData`	路线将包含基本段数据

默认值是 RouteQuery.BasicSegmentData。

travelModes : 枚举

在规划路线时应考虑的出行方式。值可以与 OR ('|') 运算符组合。

常数	描述
`RouteQuery.CarTravel`	将优化路线以满足驾车者的需求
`RouteQuery.PedestrianTravel`	将优化路线以满足步行者的需求
`RouteQuery.BicycleTravel`	将优化路线以满足骑行者的需求
`RouteQuery.PublicTransit`	将优化路线以满足使用公共交通工具者的需求
`RouteQuery.TruckTravel`	将优化路线以满足货运驾驶者的需求

默认值是 RouteQuery.CarTravel。

waypoints : 列表<坐标>

期望路线的航路点的坐标。航路点应按照从起点到终点的顺序给出。需要两个或更多坐标。

航路点可以作为 RouteQuery 类型声明的一部分设置，或使用提供的函数动态设置。

另请参阅addWaypoint、removeWaypoint 和 clearWaypoints。

方法文档

void addExcludedArea(georectangle area)

将指定的地理矩形 area 添加到排除区域（路由必须不穿越的区域）。同一个区域只能添加一次。

另请参阅removeExcludedArea 和 clearExcludedAreas。

void addWaypoint(coordinate)

将给定的 coordinate 添加到航路点列表。相同的坐标可以设置多次。

另请参阅removeWaypoint 和 clearWaypoints。

void clearExcludedAreas()

清除所有排除区域（路由必须不穿越的区域）。

另请参阅addExcludedArea 和 removeExcludedArea。

void clearWaypoints()

清除所有航路点。

另请参阅removeWaypoint 和 addWaypoint。

FeatureWeight featureWeight(FeatureType featureType)

获取 featureType 的权重。

另请参阅 featureTypes、setFeatureWeight 和 resetFeatureWeights。

void removeExcludedArea(georectangle area)

从排除区域中移除指定的 area（路必须不穿越的区域）。

另请参阅 addExcludedArea 和 clearExcludedAreas。

void removeWaypoint(coordinate)

从航点列表中移除指定的 coordinate。如果相同的坐标出现多次，则移除最后添加的坐标实例。

另请参阅 addWaypoint 和 clearWaypoints。

void resetFeatureWeights()

将所有特性权重重置为其默认状态（NeutralFeatureWeight）。

另请参阅 featureTypes、setFeatureWeight 和 featureWeight。

void setFeatureWeight(FeatureType feature, FeatureWeight weight)

在规划路线时定义要关联到 feature 的 weight。

以下列出可能的功能权重

常数	描述
`RouteQuery.NeutralFeatureWeight`	特性的存在与否不会影响路线规划
`RouteQuery.PreferFeatureWeight`	包含特性的路线优先于不包含特性的路线
`RouteQuery.RequireFeatureWeight`	仅考虑包含特性的路线，否则将返回无路线
`RouteQuery.AvoidFeatureWeight`	不包含特性的路线优先于包含特性的路线
`RouteQuery.DisallowFeatureWeight`	仅考虑不包含特性的路线，否则将返回无路线

另请参阅 featureTypes、resetFeatureWeights 和 featureWeight。