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

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

  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"