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

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"
}