用于配置对响应中地点的路线计算的参数,包括沿路线(结果排名将受到影响)和用于计算结果的旅行时间。
JSON 表示法 |
---|
{ "origin": { object ( |
字段 | |
---|---|
origin |
可选。一个显式路线起点,它会替换多段线中定义的起点。默认情况下使用多段线原点。 |
travelMode |
可选。出行方式。 |
routeModifiers |
可选。路线修饰符。 |
routingPreference |
可选。指定如何计算路由摘要。服务器会尝试使用所选的路由偏好设置来计算路由。流量感知型路由偏好设置仅适用于 |
TravelMode
出行方式选项。这些选项对应 Routes API 提供的功能。
枚举 | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
未指定出行方式。默认为 DRIVE 。 |
DRIVE |
乘坐载客车辆。 |
BICYCLE |
骑自行车旅行。不支持searchAlongRouteParameters 。 |
WALK |
步行出行。不支持searchAlongRouteParameters 。 |
TWO_WHEELER |
各种机动双轮机动车,例如滑板车和摩托车。请注意,这与涵盖人力交通工具的 BICYCLE 出行方式不同。不支持searchAlongRouteParameters 。仅适用于支持双轮机动车的国家和地区中所列的国家/地区。 |
RouteModifiers
封装计算路由时要满足的一组可选条件。
JSON 表示法 |
---|
{ "avoidTolls": boolean, "avoidHighways": boolean, "avoidFerries": boolean, "avoidIndoor": boolean } |
字段 | |
---|---|
avoidTolls |
可选。设置为 true 时,在合理情况下避开收费路段,优先考虑不包含收费路段的路线。仅适用于 |
avoidHighways |
可选。如果设置为 true,则会在合理的情况下避开高速公路,优先选择不含高速公路的路线。仅适用于 |
avoidFerries |
可选。如果设置为 true,则系统会在合理时避开轮渡,优先考虑不包含轮渡的路线。仅适用于 |
avoidIndoor |
可选。设置为 true 时,在合理的范围内避免在室内导航,优先考虑不包含室内导航的路线。仅适用于 |
RoutingPreference
一组值,用于指定计算路线时要考虑的因素。
枚举 | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
未指定路由偏好设置。默认为 TRAFFIC_UNAWARE 。 |
TRAFFIC_UNAWARE |
计算路线时不考虑实时路况信息。在路况不重要或不适用时使用。使用此值可最大限度减少延迟时间。注意:对于 、DRIVE 和 TWO_WHEELER ,系统会根据道路网和与时间无关的平均路况信息而非当前路况信息来选择路线和时长。因此,有些路线中可能会包含暂时封闭的道路。受道路网变化、平均路况信息更新以及服务的分布式性质的影响,给定请求的结果可能会随时间的推移而发生变化。此外,在时间或频率不受限制的情况下,即使两条路线几乎相同,结果还是有可能不同。 |
TRAFFIC_AWARE |
计算将实时路况信息考虑在内的路线。与 TRAFFIC_AWARE_OPTIMAL 相反,系统会应用一些优化来显著缩短延迟时间。 |
TRAFFIC_AWARE_OPTIMAL |
计算路线时将实时路况考虑在内,而不应用大多数性能优化。使用此值会产生最长的延迟时间。 |