指定要使用的流量模型类型

流量模型使用特定的算法和因素来预测 会影响指定路线的总行程时间。Routes API 提供不同的交通模型类型,以便确定计算交通时长时要优先考虑的不同因素。您可以指定想要使用 例如计算路线或路线用时 模型。设置流量模型类型后,duration 字段中返回的值会因您选择的流量模型而异。

Routes API Compute RoutesCompute Route Matrix 方法都支持交通模型类型。

默认情况下,这两种方法都使用 BEST_GUESS 流量模型类型。

指定流量类型

  1. 设置出发地和目的地。

  2. 如果您的出发时间是未来的时间,请使用 departure_time 参数。如果您没有指定出发时间, 默认为“现在”。

  3. 选择要与 trafficModel 参数搭配使用的流量模型,并 以下类型之一:

    • BEST_GUESS(默认),用于请求返回的 duration_in_traffic 是对行程时间的最佳预估,且根据两者的已知信息 历史路况信息和实时路况信息。departure_time 越接近当前时间,实时路况信息就越重要。使用默认类型 BEST_GUESS 可为大多数用例提供最有用的预测。

    • PESSIMISTIC,用于请求返回的 duration_in_traffic 对 。 此类型提供的估算时长很有可能于 大多数日子的实际行程时间。但在偶尔路况特别糟糕的时候,实际行程时间仍可能会超过此估算值。

    • OPTIMISTIC,用于请求返回的 duration_in_traffic 对 根据以往路况良好日子安排的时间。 此类型的预计时长在大多数日子里都很可能短于实际行程时间。偶尔有特殊的日子 但理想条件下仍可能比此估算值快。

    例如:

    "trafficModel": "OPTIMISTIC"

  4. 在字段掩码中指定 routes.duration 字段。

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Routes API 估算交通时间时,会使用您请求的交通模型类型。

示例:流量模型请求

例如,此请求指定使用特定出发时间的 OPTIMISTIC 交通模型类型来估算时长:

curl -X POST -H 'content-type: application/json' -d ' {
"origin": {
  "address": "Kyoto, Japan"
  },
"destination": {
  "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s"
  },
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE_OPTIMAL",
"trafficModel": "OPTIMISTIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

此请求会使用 OPTIMISTIC 流量模型返回估算的时长 行程类型:

"duration": "1238s"

如果您将流量模型类型更改为 PESSIMISTIC,则返回的时长将为 更长:

"duration": "2436s"