設定流量資料層級

您選取的流量偏好設定會以下列其中一種方式，平衡路線詳細資料的準確性與要求效能：

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

  • 不監測流量：盡可能快速傳回結果 (最低延遲時間)。

提出要求時，請權衡是否應盡可能傳回最準確的結果，或是盡可能快速傳回結果。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 搭配使用時，要求中的元素數 (起點數 × 目的地數) 不得超過

  1. 如要進一步瞭解 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"
}

設定折線上的車流量

您可以使用 Routes API 要求沿著路況感知折線的路況資訊。詳情請參閱「要求多邊形線」。