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

您选择的流量偏好设置可平衡路线详情的精确性与请求性能。当您提出要求时,您需要权衡 最好返回尽可能准确的结果, 问题。Routes API 提供了一些选项,可让您控制响应数据的质量与响应延迟时间。

设置流量数据级别

Routes API 提供 RoutingPreference (REST) 和 RoutingPreference (gRPC),用于指定计算路由的路由偏好设置。这些 他们的不同程度 在于前者会将交通状况 路线计算。每种路线偏好设置都会产生不同程度的路线质量、预计到达时间和响应延迟时间的结果。

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

  • 如果没有交通拥堵,路况就会视为正常情况, 交通顺畅地按正常的速度流动。
  • 接近高峰时段时,交通密度会增加,导致车速放慢,形成轻度到中度交通状况。
  • 在车水马龙的交通中,流速会降至零,造成严重的交通拥堵。

不了解流量

设置 TRAFFIC_UNAWARE 路线偏好设置后,系统会在不考虑当前路况的情况下计算路线。此路由偏好设置 提供最短的响应延迟时间(返回的响应最快)。

TRAFFIC_UNAWARE 是默认设置。

在响应中:

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

  • durationstaticDuration 响应属性包含相同的 值。

如果您希望系统尽快返回结果,并且大致的路线详情已经足够,请使用此路线偏好设置。

具有交通感知功能

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

在响应中:

  • 将实时路况考虑在内的预计到达时间包含在 duration 响应属性。

  • staticDuration 响应属性包含沿着路线行驶的时长,不考虑交通状况。

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

可感知路况的最佳路线

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

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

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

在回复中:

  • 将实时路况考虑在内的预计到达时间包含在 duration 响应属性。

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

此路由偏好设置提供的响应延迟时间最长(即响应返回的延迟时间最长)。在执行以下操作时,请使用此路由偏好设置 只希望获得最高质量的结果,而不必考虑响应用时所需的时间。

设置出发时间的影响

您可以选择使用 departureTime 属性设置行程的出发时间。如果未设置 departureTime 属性,则默认为 您发出请求的时间

  • 对于 TRAFFIC_UNAWARE,您无法设置 departureTime,因为系统会根据道路网和与时间无关的平均路况信息来选择路线和时长。

  • 对于会考虑实时路况信息的 TRAFFIC_AWARETRAFFIC_AWARE_OPTIMALdepartureTime 越接近当前时间,实时路况信息就越重要。您设置的出发时间越靠近未来,系统就越会考虑历史交通状况。

路由偏好设置示例

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