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

流量模型會使用特定的演算法和因素，預測特定路線的交通狀況對總交通時間的影響。Routes API 提供不同的流量模型類型，可優先採用用於計算流量時間長度的不同因素。您可以在計算路線或路徑矩陣的持續時間時，指定路徑要使用的流量模型類型。設定流量模型類型時，duration 欄位傳回的值會因您選擇的流量模型而異。

Routes API Compute Routes 和 Compute 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"

    PESSIMISTIC

  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"