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