Routes Preferred API 提供了三种用于计算路线的路线偏好设置。它们在将路况信息纳入路线计算的程度上有所不同。每种路线偏好设置都会生成在路线质量、预计到达时间 (ETA) 和响应延迟时间方面存在一定差异的结果。
路况信息简介
路况信息用于描述车流速度。例如:
如果没有拥堵,路况信息会被视为正常,车流会以常规的畅通速度行驶。
临近高峰时段,车流密度会增加,导致车速减慢,从而产生轻微到中度的路况信息。
在车流拥堵的情况下,车流速度会降至零,从而产生严重的路况信息。
不考虑路况信息
如果您设置了
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" }