路况模型使用特定算法和因素来预测路况信息如何影响给定路线的总行程时间。Routes API 提供不同的流量模型类型,用于对计算交通时长时使用的不同因素进行优先级排序。您可以指定在计算路线或路线矩阵的时长时,路线要使用的流量模型类型。设置流量模型类型时,duration
字段中返回的值会因您选择的流量模型而异。
Routes API Compute Routes
和 Compute Route Matrix
方法均支持流量模型类型。
默认情况下,这两种方法都使用 BEST_GUESS
流量模型类型。
指定流量类型
设置出发地和目的地。
如果您的出发时间是将来的时间,请使用
departure_time
参数添加时间。如果您未指定出发时间,则默认为现在。选择要与
trafficModel
参数以及以下类型之一使用的流量模型:BEST_GUESS
(默认),用于请求返回的duration_in_traffic
是根据已知历史路况信息和实时路况信息得出的最准确的行程时间估算值。departure_time
越接近当前时间,实时路况信息就越重要。使用默认类型的BEST_GUESS
可为绝大多数用例提供最有用的预测。PESSIMISTIC
,用于请求返回的duration_in_traffic
根据路况不佳日的历史路况信息对时间进行建模。此类型提供的预计时长很有可能长于大多数日子里的实际行程时间。偶尔天气状况特别恶劣的日子,可能仍会超过此估算值。OPTIMISTIC
,用于请求返回的duration_in_traffic
根据路况良好日子的历史路况信息对时间进行建模。此类型提供的预计时长很有可能比大多数日子里的实际行程时间短一些。偶尔天气状况特别好的日子可能仍然会比此估算值快。
例如:
"trafficModel": "OPTIMISTIC"
。在字段掩码中指定
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"