RoutingParameters

用于配置对响应中地点的路线计算的参数,包括沿路线(结果排名将受到影响)和用于计算结果的旅行时间。

JSON 表示法
{
  "origin": {
    object (LatLng)
  },
  "travelMode": enum (TravelMode),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "routingPreference": enum (RoutingPreference)
}
字段
origin

object (LatLng)

可选。一个显式路线起点,用于替换多段线中定义的起点。默认情况下使用多段线原点。

travelMode

enum (TravelMode)

可选。出行方式。

routeModifiers

object (RouteModifiers)

可选。路线修饰符。

routingPreference

enum (RoutingPreference)

可选。指定如何计算路由摘要。服务器会尝试使用所选的路由偏好设置来计算路由。流量感知型路由偏好设置仅适用于 DRIVETWO_WHEELER travelMode

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

boolean

可选。如果设置为 true,则会在合理的情况下避开收费道路,优先选择不含收费道路的路线。仅适用于 DRIVETWO_WHEELER TravelMode

avoidHighways

boolean

可选。如果设置为 true,则会在合理的情况下避开高速公路,优先选择不含高速公路的路线。仅适用于 DRIVETWO_WHEELER TravelMode

avoidFerries

boolean

可选。如果设置为 true,则会在合理的情况下避开轮渡,优先选择不含轮渡的路线。仅适用于 DRIVETWO_WHEELER TravelMode

avoidIndoor

boolean

可选。如果设为 true,则在合理的情况下避免在室内导航,优先选择不包含室内导航的路线。仅适用于 WALK TravelMode

RoutingPreference

一组值,用于指定计算路线时要考虑的因素。

枚举
ROUTING_PREFERENCE_UNSPECIFIED 未指定路由偏好设置。默认为 TRAFFIC_UNAWARE
TRAFFIC_UNAWARE 计算路线时不考虑实时路况。当交通状况不重要或不适用时,此值适用。使用此值可最大限度减少延迟时间。注意:对于TravelModeDRIVE)和TWO_WHEELER,选择的路线和时长是根据道路网和与时间无关的平均路况信息(而不是当前路况信息)得出的。因此,路线可能包括暂时关闭的道路。受道路网变化、平均路况信息更新以及服务的分布式性质的影响,给定请求的结果可能会随时间的推移而发生变化。此外,在时间或频率不受限制的情况下,即使两条路线几乎相同,结果还是有可能不同。
TRAFFIC_AWARE 计算路线时会考虑实时路况。与 TRAFFIC_AWARE_OPTIMAL 相反,系统会应用一些优化来显著缩短延迟时间。
TRAFFIC_AWARE_OPTIMAL 计算路线时会考虑实时交通状况,但不会应用大多数性能优化。使用此值会产生最长的延迟时间。