PySide6.QtLocation.QGeoRouteRequest

class QGeoRouteRequest

QGeoRouteRequest 类表示定义路由信息请求的参数和限制。更多…

概要

方法

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

QGeoRouteRequest 实例的默认状态将导致请求基本的路线段和导航操作，描述通过汽车覆盖给定路点的最快路线。

不同路由信息提供商支持的功能可能存在显著差异，甚至同一提供商在使用不同授权级别时支持的功能也可能有所不同。

QGeoRoutingManager 中有几个函数可以用来检查当前提供商和授权级别支持哪些功能。

另请参阅

QGeoRoutingManager

class TravelMode

(继承 enum.Flag) 定义用于路线的旅行模式。

常量

描述

QGeoRouteRequest.CarTravel

路线将针对驾驶汽车的人进行优化。

QGeoRouteRequest.PedestrianTravel

路线将针对步行者进行优化。

QGeoRouteRequest.BicycleTravel

路线将针对骑自行车的人进行优化。

QGeoRouteRequest.PublicTransitTravel

路线将优化为使用公共交通工具的人。

QGeoRouteRequest.TruckTravel

路线将针对驾驶卡车的人进行优化。
class FeatureType

(继承自 enum.Flag) 定义对路线规划重要的特性。

这些值将与FeatureWeight结合使用，以确定它们是否应该成为路线的一部分。

常量

描述

QGeoRouteRequest.NoFeature

由supportedFeatureTypes()使用，表示在规划路线时不会考虑任何特征。

QGeoRouteRequest.TollFeature

在规划路线时考虑收费道路。

QGeoRouteRequest.HighwayFeature

在规划路线时考虑高速公路。

QGeoRouteRequest.PublicTransitFeature

在规划路线时考虑公共交通。

QGeoRouteRequest.FerryFeature

在规划路线时考虑渡轮。

QGeoRouteRequest.TunnelFeature

在规划路线时考虑隧道。

QGeoRouteRequest.DirtRoadFeature

在规划路线时考虑土路。

QGeoRouteRequest.ParksFeature

在规划路线时考虑公园。

QGeoRouteRequest.MotorPoolLaneFeature

在规划路线时考虑机动车道。

QGeoRouteRequest.TrafficFeature

在规划路线时考虑当前的交通状况。自QtLocation 5.10起
class FeatureWeight

(继承自 enum.Flag) 定义在规划路线时与特征相关联的权重。

这些值将与QGeoRouteRequest::Feature结合使用，以确定它们是否应该成为路线的一部分。

常量

描述

QGeoRouteRequest.NeutralFeatureWeight

该特征的存在与否不会影响路线的规划。

QGeoRouteRequest.PreferFeatureWeight

包含该特性的路线将优先于不包含该特性的路线。

QGeoRouteRequest.RequireFeatureWeight

只有包含该特性的路线才会被考虑，否则不会返回任何路线。

QGeoRouteRequest.AvoidFeatureWeight

不包含该特征的路线将优先于包含该特征的路线。

QGeoRouteRequest.DisallowFeatureWeight

仅考虑不包含该特征的路线，否则不会返回任何路线。
class RouteOptimization

(继承自 enum.Flag) 定义应用于路线规划优化的类型。

常量

描述

QGeoRouteRequest.ShortestRoute

最小化行程长度。

QGeoRouteRequest.FastestRoute

最小化行程的旅行时间。

QGeoRouteRequest.MostEconomicRoute

最小化旅程的成本。

QGeoRouteRequest.MostScenicRoute

最大化旅程的风景潜力。
class SegmentDetail

(继承自 enum.Flag) 定义应包含在路由中的路由段信息的数量。

常量

描述

QGeoRouteRequest.NoSegmentData

不应包含路段数据的路线。使用此级别路段细节请求的路线将初始化path()为前一个和下一个QGeoManeuver实例位置之间的直线。

QGeoRouteRequest.BasicSegmentData

基本段数据将包含在路线中。这将包括 path() 。
class ManeuverDetail

(继承自 enum.Flag) 定义应包含在路线中的机动信息量。

常量

描述

QGeoRouteRequest.NoManeuvers

路线中不应包含任何操作。

QGeoRouteRequest.BasicManeuvers

基本操作将包含在路线中。这将包括 instructionText() 。
__init__(other)
Parameters:

其他 – QGeoRouteRequest

从other的内容构造一个路由请求对象。

__init__([waypoints=list()])
Parameters:

waypoints – QGeoCoordinate 的列表

构建一个请求，通过坐标waypoints计算路线。

该路线将按顺序遍历waypoints的对象。

__init__(origin, destination)
Parameters:

构建一个请求来计算origin和destination之间的路线。

departureTime()
Return type:

QDateTime

返回请求中的出发时间。

另请参阅

setDepartureTime()

excludeAreas()
Return type:

QGeoRectangle 的列表

返回路线不能穿过的区域。

另请参阅

setExcludeAreas()

featureTypes()
Return type:

.list of QGeoRouteRequest.FeatureType

返回在规划路线时将考虑的特征列表。权重为NeutralFeatureWeight的特征将不会被返回。

featureWeight(featureType)
Parameters:

featureType – FeatureType

Return type:

FeatureWeight

返回在路线规划中分配给featureType的权重。

如果没有为featureType指定特征权重，则将返回NeutralFeatureWeight。

另请参阅

setFeatureWeight()

maneuverDetail()
Return type:

ManeuverDetail

返回将用于表示路线操作的详细程度。

另请参阅

setManeuverDetail()

numberAlternativeRoutes()
Return type:

整数

返回将请求的替代路线的数量。

__ne__(rhs)
Parameters:

rhs – QGeoRouteRequest

Return type:

布尔

返回路由请求lhs和rhs是否不相等。

__eq__(rhs)
Parameters:

rhs – QGeoRouteRequest

Return type:

布尔

返回路由请求lhs和rhs是否相等。

routeOptimization()
Return type:

RouteOptimization的组合

返回此请求指定的优化标准，该标准应在规划路线时使用。

另请参阅

setRouteOptimization()

segmentDetail()
Return type:

SegmentDetail

返回将用于表示路由段的详细级别。

另请参阅

setSegmentDetail()

setDepartureTime(departureTime)
Parameters:

departureTime – QDateTime

设置路线计算的出发时间 departureTime。后端可以使用此信息来计算更快的路线，例如，通过避免高峰时段的交通拥堵。

默认值是一个无效的QDateTime。

另请参阅

departureTime()

setExcludeAreas(areas)
Parameters:

areas – QGeoRectangle 的列表

将areas设置为路线不得穿越的排除区域。

另请参阅

excludeAreas()

setFeatureWeight(featureType, featureWeight)
Parameters:

在路线规划期间，将权重 featureWeight 分配给特征 featureType。

默认情况下，所有特征都被赋予了一个权重NeutralFeatureWeight。

无法为NoFeature分配权重。

另请参阅

featureWeight()

setManeuverDetail(maneuverDetail)
Parameters:

maneuverDetail – ManeuverDetail

设置用于表示路线操作的详细级别为maneuverDetail。

默认值为 BasicManeuvers 。

另请参阅

maneuverDetail()

setNumberAlternativeRoutes(alternatives)
Parameters:

备选方案 – 整数

设置请求的替代路线数量为alternatives。如果alternatives为负数，则替代路线的数量设置为0。

默认值为0。

setRouteOptimization(optimization)
Parameters:

优化 – RouteOptimization 的组合

设置规划路线时使用的优化标准为optimization。

默认值为FastestRoute。

另请参阅

routeOptimization()

setSegmentDetail(segmentDetail)
Parameters:

segmentDetail – SegmentDetail

设置用于表示路由段的详细级别为segmentDetail。

另请参阅

segmentDetail()

setTravelModes(travelModes)
Parameters:

travelModes – TravelMode 的组合

设置应在路线规划期间考虑的旅行模式为travelModes。

默认值为 CarTravel 。

另请参阅

travelModes()

setWaypoints(waypoints)
Parameters:

waypoints – QGeoCoordinate 的列表

设置 waypoints 作为路线应经过的航点。

航点应按从起点到目的地的顺序给出。

在航点被设置为包含两个或更多坐标的列表之前，此请求将无效。

另请参阅

waypoints()

swap(other)
Parameters:

其他 – QGeoRouteRequest

travelModes()
Return type:

TravelMode的组合

返回此请求指定的在路线规划期间应考虑的出行模式。

另请参阅

setTravelModes()

waypoints()
Return type:

QGeoCoordinate的列表

返回路线将经过的航点。

另请参阅

setWaypoints()