您选择的路况信息偏好设置可平衡路线详情的准确性 以及请求性能当您提出要求时,您需要权衡 最好返回尽可能准确的结果, 尽可能快地完成任务Routes API 提供的选项可让您控制 响应数据的质量与响应延迟时间的对比。
设置流量数据级别
Routes API 提供 RoutingPreference (REST) 和 RoutingPreference (gRPC),可让您指定路线计算的路线偏好设置。这些 他们的不同程度 在于前者会将交通状况 路线计算。每个路由首选项产生的结果与 与路线质量、预计预计到达时间和响应延迟时间有关的程度。
路况信息表明了交通流量的速率。例如:
- 如果没有交通拥堵,路况就会视为正常情况, 交通顺畅地按正常的速度流动。
- 接近高峰时段时,交通密度会增加,导致车速放慢,从而形成轻度到中度交通状况。
- 在导视广告之间,流量会停滞, 实时路况。
不了解流量
当您设定 TRAFFIC_UNAWARE
路线偏好时,系统会计算路线
而不会考虑当前路况信息。此路由偏好设置
提供最短的响应延迟时间(返回的响应最快)。
TRAFFIC_UNAWARE
是默认设置。
在响应中:
预计到达时间包含在
duration
响应属性中。duration
和staticDuration
响应属性包含相同的 值。
如果您希望以最快的速度返回响应,请使用此路由偏好设置, 大致的路线详情就足够了。
可感知路况
当您设定 TRAFFIC_AWARE
路线偏好时,系统会计算路线
会将当前路况考虑在内。因此,路线和路线详情更准确地反映了实际情况。因为这导致
数据质量以响应延迟、性能优化为代价
以缩短延迟时间
在响应中:
考虑实时交通状况的预计到达时间包含在
duration
响应属性中。staticDuration
响应属性包含行程时长 而不会考虑路况信息。
如果您希望获得更准确的路由详细信息,请使用此路由偏好设置
TRAFFIC_UNAWARE
,但您并不介意在返回响应时返回
延迟时间会适度增加
可感知路况的最佳路线
设置 TRAFFIC_AWARE_OPTIMAL
路线偏好设置后,系统会考虑当前的交通状况来计算路线,但不会应用任何性能优化。在此模式下,服务器会对道路网格执行更为详尽的搜索,以查找最佳路线。
TRAFFIC_AWARE_OPTIMAL
路由偏好设置等效于
maps.google.com 以及
Google 地图移动应用。
将此选项与计算路线矩阵结合使用时, 请求中的元素数量(出发地数量 × 目的地数量)不能超过 100。有关计算路线矩阵限制的详细信息,请参阅 计算路由矩阵。
在响应中:
考虑实时交通状况的预计到达时间包含在
duration
响应属性中。staticDuration
响应属性包含行程时长 而不会考虑路况信息。
此路由偏好设置提供的响应延迟时间最长(即响应返回的延迟时间最长)。如果您希望获得最高质量的结果,而不考虑响应所需的时间,请使用此路由偏好设置。
设置出发时间的影响
您可以选择使用 departureTime
属性设置行程的出发时间。如果您未设置 departureTime
属性,则默认为您发出请求的时间。
对于
TRAFFIC_UNAWARE
,您无法设置departureTime
,因为 路线和持续时间根据道路网和平均时间无关 实时路况。适用于
TRAFFIC_AWARE
和TRAFFIC_AWARE_OPTIMAL
(需要获取实时路况信息) 所有环境,实时流量就变得越来越重要了departureTime
离现在更近的位置。您设置的出发时间距离越远 未来会越来越多地考虑历史流量 条件。
路由偏好设置示例
以下 JSON 代码演示了如何在 请求消息实体正文。
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }
配置多段线上的路况
借助 Routes API,您可以请求有关路况信息的信息 沿路况感知型多段线绘制。请参阅 如需了解详情,请参阅请求多段线。