用于配置对响应中地点的路线计算的参数,包括沿路线(结果排名将受到影响)和用于计算结果的旅行时间。
JSON 表示法 |
---|
{ "origin": { object ( |
字段 | |
---|---|
origin |
可选。一个显式路线起点,用于替换多段线中定义的起点。默认情况下使用多段线原点。 |
travel |
可选。出行方式。 |
route |
可选。路线修饰符。 |
routing |
可选。指定如何计算路由摘要。服务器会尝试使用所选的路由偏好设置来计算路由。流量感知型路由偏好设置仅适用于 |
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 } |
字段 | |
---|---|
avoid |
可选。如果设置为 true,则会在合理的情况下避开收费道路,优先选择不含收费道路的路线。仅适用于 |
avoid |
可选。如果设置为 true,则会在合理的情况下避开高速公路,优先选择不含高速公路的路线。仅适用于 |
avoid |
可选。如果设置为 true,则会在合理的情况下避开轮渡,优先选择不含轮渡的路线。仅适用于 |
avoid |
可选。如果设为 true,则在合理的情况下避免在室内导航,优先选择不包含室内导航的路线。仅适用于 |
RoutingPreference
一组值,用于指定计算路线时要考虑的因素。
枚举 | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
未指定路由偏好设置。默认为 TRAFFIC_UNAWARE 。 |
TRAFFIC_UNAWARE |
计算路线时不考虑实时路况。当交通状况不重要或不适用时,此值适用。使用此值可最大限度减少延迟时间。注意:对于 (DRIVE )和TWO_WHEELER ,选择的路线和时长是根据道路网和与时间无关的平均路况信息(而不是当前路况信息)得出的。因此,路线可能包括暂时关闭的道路。受道路网变化、平均路况信息更新以及服务的分布式性质的影响,给定请求的结果可能会随时间的推移而发生变化。此外,在时间或频率不受限制的情况下,即使两条路线几乎相同,结果还是有可能不同。 |
TRAFFIC_AWARE |
计算路线时会考虑实时路况。与 TRAFFIC_AWARE_OPTIMAL 相反,系统会应用一些优化来显著缩短延迟时间。 |
TRAFFIC_AWARE_OPTIMAL |
计算路线时会考虑实时交通状况,但不会应用大多数性能优化。使用此值会产生最长的延迟时间。 |