設定品質與延遲時間的取捨

Routes Preferred API 提供三種路線偏好設定，用於計算路線。兩者的差異在於將路況納入路線計算的程度。每種路由偏好設定產生的結果，在路線品質、預計到達時間和回應延遲時間方面，都會有一定程度的差異。

關於路況

路況是指車流量。例如：

• 如果沒有塞車，路況會視為正常，車流會以正常暢通的速度行進。

• 接近尖峰時段時，車流量增加，導致車速變慢，路況變得輕微到中度壅塞。

• 在車輛首尾相接的情況下，流量會停滯不前，造成路況壅塞。

不考量路況

設定 TRAFFIC_UNAWARE 路線規劃偏好設定時，系統計算路線時不會考量路況。這項轉送偏好設定可提供最低的回應延遲時間 (最快傳回回應)。

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

路況感知

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

如需更精確的路線詳細資料，且不介意回應延遲時間略為增加，請使用這項路線偏好設定。

車流量監測最佳路線

設定 TRAFFIC_AWARE_OPTIMAL 路線偏好設定時，系統會根據路況計算路線，但不會套用任何效能最佳化設定。在這種模式下，伺服器會更全面地搜尋道路網路，找出最佳路線。

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

範例

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

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