流量模型會使用特定的演算法和因素來預測流量
條件會影響指定路線的總交通時間。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"