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

您选择的路况信息偏好设置可平衡路线详情的准确性 以及请求性能当您提出要求时，您需要权衡 最好返回尽可能准确的结果， 问题。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，您可以请求有关路况的信息 沿路况感知型多段线绘制。请参阅 如需了解详情，请参阅请求多段线。