設定流量資料層級

歐洲經濟區 (EEA) 開發人員

您選取的車流量偏好設定,會透過下列兩種方式之一,平衡路線詳細資料的準確度和要求效能:

  • 車流量監測:傳回最準確的結果 (延遲時間較長)。

  • 不監測車流量:盡快傳回結果 (延遲時間最短)。

提出要求時,請衡量是要盡可能傳回最準確的結果,還是盡快傳回結果。Routes API 提供多個選項,可讓您控制回應資料品質與回應延遲時間。

如何設定車流量

Routes API 提供 RoutingPreference (REST) 和 RoutingPreference (gRPC),可讓您指定計算路線時的路線偏好設定。

預設為不考量路況的結果。您可以使用 TRAFFIC_UNAWARE、TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 路線偏好設定選取車流量選項。每種路線偏好設定產生的結果,在路線品質、預計到達時間和回應延遲時間方面都有所不同。

路況

路況會影響車流量:

  • 車流正常:沒有塞車,車流以正常速度行進。

  • 車流順暢至中等:車流逐漸增加,車速減慢。

  • 交通壅塞:嚴重塞車,車速大幅降低。

不考量路況

TRAFFIC_UNAWARE 是預設設定。如果想盡快取得回應,且大致的路線詳細資料就足夠,請使用這個路線偏好設定。

計算 TRAFFIC_UNAWARE 路線時,不會考量目前路況。這項轉送偏好設定可讓要求回應速度最快 (延遲時間最短)。

如果您選擇 TRAFFIC_UNAWARE,系統會根據路網及與時間無關的平均路況來選擇路線和時間,不會考量目前路況。因此,路線可能會包含暫時封閉的道路。受到路網變動、平均路況更新,以及這項服務的分散性質影響,特定要求的結果可能會隨時間而改變。此外,在時間或頻率都沒有限制的情況下,即使兩條路線幾乎相同,結果還是有可能不同。

您會看到以下回應:

  • duration:包含路線的預計到達時間。

  • staticDuration:僅考量歷來路況資訊的路線預計到達時間。如果是 TRAFFIC_UNAWARE,這個欄位的值會與 duration 相同。

交通感知

如果需要比 TRAFFIC_UNAWARE 更準確的路線詳細資料,且不介意回應延遲時間稍微增加,請使用這項路線偏好設定。

設定 TRAFFIC_AWARE 路線偏好設定時,服務會考量目前路況來計算路線。因此,路線和路線詳細資料能更準確地反映實際情況。由於資料品質提升會導致回應延遲時間增加,因此系統會套用效能最佳化功能,大幅減少延遲時間。

您會看到以下回應:

  • duration:考量即時路況資訊後的預計到達時間。

  • staticDuration:僅考量歷來路況資訊時,路線的預計到達時間。

車流量監測最佳路線

如果想取得最高品質的結果,且不在意回覆時間,請使用這項轉送偏好設定。這項轉送偏好設定在傳回回應時的延遲時間最長 (延遲時間最高)。

設定 TRAFFIC_AWARE_OPTIMAL 路線規劃偏好設定時,服務會考量目前路況計算路線,但不會套用效能最佳化。在這個模式下,伺服器會更全面地搜尋道路網路,找出最佳路線。

TRAFFIC_AWARE_OPTIMAL 路線偏好設定等同於 maps.google.com 和 Google 地圖行動應用程式使用的模式。

如果將這個選項與 Compute Route Matrix 搭配使用,要求中的元素數量 (起點數量 × 目的地數量) 會受到限制。如要進一步瞭解 Compute Route Matrix 限制,請參閱「計算路徑矩陣」。

您會看到以下回應:

  • duration:考量即時路況資訊後,路線的預計到達時間。

  • staticDuration:僅考量歷來路況資訊的路線預計到達時間。

設定出發時間 (選用)

這項屬性僅適用於需要將出發時間設為未來時間的車流量感知要求。如未設定 departureTime 屬性,系統會預設為提出要求的時間。

如要調整服務在選擇路線時預測路況的方式,請使用 departureTime 屬性,以及 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 選項。

  • TRAFFIC_UNAWARE:不建議,因為路線和所需時間的選擇取決於路網,以及不考慮時間的平均路況。

  • TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL:建議用於近期出發的行程,因為這些偏好設定會考量即時路況。departureTime 距離現在的時間越近,即時車流量的影響力就越大。出發時間設得越晚,系統在選擇路線時,就越會考量歷來路況。

範例:如何選取車流量監測路線

下列 JSON 程式碼示範如何在要求訊息實體主體中設定 TRAFFIC_AWARE_OPTIMAL 轉送偏好設定。

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}