指定是否要納入流量資料，以及如何加入

你選取的流量偏好設定可平衡路線詳細資料的準確性 以及要求效能提出要求時，您需要權衡是否應盡可能傳回最準確的結果，或是盡可能快速傳回結果。Routes API 提供多種選項 比較回應資料的品質和回應延遲時間。

設定流量資料層級

Routes API 提供 RoutingPreference (REST) 和 RoutingPreference (gRPC)，指定計算路徑的轉送偏好設定。這些偏好設定會將交通狀況納入路線計算，但考量程度不同。每個路徑偏好設定的結果，在路徑品質、預估到達時間和回應延遲方面都會有所差異。

路況會顯示交通流量速度。例如：

  • 在沒有壅塞的情況下，系統會將路況視為正常，並以正常的無阻礙速度流動。
  • 接近尖峰時段，車流密度增加，導致車流速度變慢，造成車流量從輕度到中度。
  • 在車水馬龍的交通狀況下，流量率會停滯不前，導致交通擁塞。

不瞭解流量

設定 TRAFFIC_UNAWARE 路徑偏好設定時，系統會計算路線，但不會考量目前的交通狀況。這項轉送偏好設定 可提供最低的回應延遲時間 (回應會以最快的速度傳回)。

TRAFFIC_UNAWARE 為預設設定。

在回覆中：

  • 預計到達時間包含在 duration 回應屬性中。

  • duration 和 staticDuration 回應屬性包含相同的值。

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

路況感知

設定 TRAFFIC_AWARE 轉送偏好設定後，系統就會計算路徑 考量目前的路況整合到這個過程 資料能更準確地反映實際情況。由於資料品質提升會導致回應延遲時間增加，因此我們會套用效能最佳化功能，大幅縮短延遲時間。

在回應中：

  • duration 回應資源包含考量即時流量的預估廣告費用。

  • staticDuration 回應屬性包含移動所需時間 不考慮路況。

如果您想要比 TRAFFIC_UNAWARE 更準確的路徑詳細資料，但不介意回應的延遲時間略微增加，請使用這個路徑偏好設定。

交通監測功能最佳

如果設定「TRAFFIC_AWARE_OPTIMAL」轉送偏好設定，路徑將為 計算結果是將目前的路況列入考量，但沒有成效 並套用最佳化設定在此模式下，伺服器會執行 搜尋路網，找出最佳路線。

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

搭配 Compute Route Matrix 使用這個選項時，系統顯示的 要求中的元素數量 (起點數量 × 目的地數量) 不得超過 100。如要進一步瞭解 Compute Route Matrix 限制，請參閱「計算路徑矩陣」。

在回應中：

  • duration 回應資源包含考量即時流量的預估廣告費用。

  • staticDuration 回應屬性包含路線的旅行時間，不考慮交通狀況。

這個轉送偏好設定可提供最高的回應延遲時間 (也就是回應傳回的延遲時間最長)。這個轉送偏好設定用於 希望無論回覆時間有多長，都能取得最高品質的結果。

設定出發時間的影響

您可以選用 departureTime 屬性來設定 行程。如未設定 departureTime 屬性，該屬性會預設為 發出要求的時間

  • 您無法在 TRAFFIC_UNAWARE 中設定 departureTime，因為 路線和所需時間取決於路網及不考量時間的平均時間 路況。

  • 適用於 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL (使用即時路況) 考量條件後，即時車流量變得更加重要 departureTime距離現在更近。您設定的出發時間越晚，系統就會越重視歷來交通狀況。

設定路徑偏好設定的範例

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

設定折線上的車流量

您可以使用 Routes API 要求沿著路況感知折線的路況資訊。詳情請見 要求折線以取得更多資訊。