流量模型會使用特定演算法和因素,預測路況如何影響特定路線的總交通時間。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"
PESSIMISTIC
在欄位遮罩中指定
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"