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" }