Routes Preferred API 提供三种用于计算路线的路线偏好设置。它们的不同之处在于,在计算路线时考虑交通状况的程度不同。每种路线偏好设置都会生成在路线质量、预计到达时间和响应延迟方面有所不同的结果。
路况信息简介
路况信息用于描述交通流量的速率。例如:
如果没有拥堵,路况会被视为正常,车流会以正常的畅通速度行驶。
临近高峰时段,交通密度增加,导致交通速度减慢,从而形成轻度到中度的交通状况。
在拥堵的交通状况下,流量会降至最低,从而导致交通严重拥堵。
不了解路况
如果您设置了 TRAFFIC_UNAWARE
路线偏好设置,系统在计算路线时不会考虑路况。此路由偏好设置可提供最低的响应延迟时间(最快返回响应)。
如果您希望尽快获得返回的响应,并且近似的路线详情就足够了,请使用此路线偏好设置。
感知路况
设置 TRAFFIC_AWARE
路线偏好设置后,系统会根据路况信息计算路线。因此,路线和路线详情能更准确地反映现实情况。由于数据质量的提高是以牺牲响应延迟时间为代价的,因此我们应用了性能优化来大幅缩短延迟时间。
如果您希望获得更准确的路线详情,但可以接受响应延迟略有增加,请使用此路线偏好设置。
可感知路况的最佳路线
当您设置 TRAFFIC_AWARE_OPTIMAL
路线偏好设置时,系统会根据路况信息计算路线,但不会应用任何性能优化。在此模式下,服务器会更全面地搜索道路网络,以找到最佳路线。
此路由偏好设置会带来最长的响应延迟时间(即,响应返回的延迟时间最长)。如果您希望获得最高质量的结果,而不考虑响应时间,请使用此路由偏好设置。
示例
以下 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" }