您选择的路况信息偏好设置可平衡路线详情的准确性 以及请求性能当您提出要求时,您需要权衡 最好返回尽可能准确的结果, 问题。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,您可以请求有关路况的信息 沿路况感知型多段线绘制。请参阅 如需了解详情,请参阅请求多段线。