Back to Qt.io
Contact Us Blog Download Qt

RouteQuery QML Type

RouteQuery 类型用于向RouteModel... 更多...

Import Statement: import QtLocation 6.9
Since: QtLocation 5.5

属性

方法

详细说明

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

这些参数描述了路线的关键细节，如要经过的waypoints 、要避开的excludedAreas 、正在使用的travelModes ，以及如何优化路线的详细偏好和沿途要优先选择或避开的特征（如收费公路、高速公路等）。

RouteQuery 对象专门用于填写RouteModel'query 属性的值，然后开始检索过程以填充模型。

某些插件可能允许或要求使用特定参数进行操作。为了指定这些特定于插件的参数，可以在 RouteQuery 中嵌套 MapParameter 元素。

使用示例

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

RouteQuery {
    id: aQuery
}

RouteModel {
    query: aQuery
    autoUpdate: false
}

有关更完整的示例，请参阅RouteModel 类型的文档和 Mapviewer 示例。

另请参阅 RouteModel 。

属性文档

departureTime : date

查询路线时使用的出发时间。默认值为无效日期，即查询时不会使用出发时间。


excludedAreas : list<georectangle>

路线不得穿越的区域。

排除区域可作为RouteQuery 类型声明的一部分进行设置，也可使用所提供的函数进行动态设置。

另请参阅 addExcludedArea,removeExcludedArea, 和clearExcludedAreas 。


featureTypes : QList<FeatureType> [read-only]

规划路线时将考虑的地物列表。权重为 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 : enumeration

表示路线段时使用的详细程度。

常数说明
RouteQuery.NoSegmentData路线中不包含路段数据
RouteQuery.BasicSegmentData路线将包含基本路段数据

默认值为RouteQuery.BasicSegmentData 。


travelModes : enumeration

规划路线时应考虑的旅行模式。可使用 OR（'|'）操作符组合数值。

常数说明
RouteQuery.CarTravel为开车的人优化路线
RouteQuery.PedestrianTravel为步行者优化路线
RouteQuery.BicycleTravel为骑自行车的人优化路线
RouteQuery.PublicTransit出行 路线将针对使用公共交通的人进行优化
RouteQuery.TruckTravel为驾驶卡车的人优化路线

默认值为RouteQuery.CarTravel 。


waypoints : list<coordinate>

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

航点可作为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 。


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