指定如何以及是否包括流量数据

您选择的路况信息偏好设置可平衡路线详情的准确性 以及请求性能当您提出要求时，您需要权衡 最好返回尽可能准确的结果， 尽可能快地完成任务Routes API 提供的选项可让您控制 响应数据的质量与响应延迟时间的对比。

注意 ：使用 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 的请求会产生费用 更新频率详细了解结算。

设置流量数据级别

Routes API 提供 RoutingPreference (REST) 和 RoutingPreference (gRPC)，可让您指定路线计算的路线偏好设置。这些 他们的不同程度 在于前者会将交通状况 路线计算。每个路由首选项产生的结果与 与路线质量、预计预计到达时间和响应延迟时间有关的程度。

路况信息表明了交通流量的速率。例如：

• 如果没有交通拥堵，路况就会视为正常情况， 交通顺畅地按正常的速度流动。
• 接近高峰时段时，交通密度会增加，导致车速放慢，从而形成轻度到中度交通状况。
• 在导视广告之间，流量会停滞， 实时路况。

不了解流量

当您设定 TRAFFIC_UNAWARE 路线偏好时，系统会计算路线 而不会考虑当前路况信息。此路由偏好设置 提供最短的响应延迟时间（返回的响应最快）。

TRAFFIC_UNAWARE 是默认设置。

如果您选择 TRAFFIC_UNAWARE，则系统会根据道路网和与时间无关的平均路况信息而非当前路况信息来选择路线和时长。因此，路线可能包括暂时关闭的道路。受道路网变化、平均路况信息更新以及服务的分布式性质的影响，给定请求的结果可能会随时间的推移而发生变化。两个不同之间的效果也可能存在差异 在任意时间或频率不受限制的情况下，计算几乎相等的路线。

。

在响应中：

• 预计到达时间包含在 duration 响应属性中。

• duration 和 staticDuration 响应属性包含相同的 值。

如果您希望以最快的速度返回响应，请使用此路由偏好设置， 大致的路线详情就足够了。

注意 ：此设置相当于未采用当前流量的 Directions API 和 Distance Matrix API。

可感知路况

当您设定 TRAFFIC_AWARE 路线偏好时，系统会计算路线 会将当前路况考虑在内。因此，路线和路线详情更准确地反映了实际情况。因为这导致 数据质量以响应延迟、性能优化为代价 以缩短延迟时间

在响应中：

• 考虑实时交通状况的预计到达时间包含在 duration 响应属性中。

• staticDuration 响应属性包含行程时长 而不会考虑路况信息。

如果您希望获得更准确的路由详细信息，请使用此路由偏好设置 TRAFFIC_UNAWARE，但您并不介意在返回响应时返回 延迟时间会适度增加

注意 ：这是 Routes API 新增设置，在 Directions API 和 Distance Matrix API。

可感知路况的最佳路线

设置 TRAFFIC_AWARE_OPTIMAL 路线偏好设置后，系统会考虑当前的交通状况来计算路线，但不会应用任何性能优化。在此模式下，服务器会对道路网格执行更为详尽的搜索，以查找最佳路线。

TRAFFIC_AWARE_OPTIMAL 路由偏好设置等效于 maps.google.com 以及 Google 地图移动应用。

将此选项与计算路线矩阵结合使用时， 请求中的元素数量（出发地数量 × 目的地数量）不能超过 100。有关计算路线矩阵限制的详细信息，请参阅 计算路由矩阵。

在响应中：

• 考虑实时交通状况的预计到达时间包含在 duration 响应属性中。

• staticDuration 响应属性包含行程时长 而不会考虑路况信息。

此路由偏好设置提供的响应延迟时间最长（即响应返回的延迟时间最长）。如果您希望获得最高质量的结果，而不考虑响应所需的时间，请使用此路由偏好设置。

注意 ：此选项等同于在departure_time Directions API 和 Distance Matrix API。

设置出发时间的影响

您可以选择使用 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，您可以请求有关路况信息的信息 沿路况感知型多段线绘制。请参阅 如需了解详情，请参阅请求多段线。