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

您選取的流量偏好設定可平衡路線詳細資料的準確度與請求效能。提出要求時,您需要權衡是否應盡可能傳回最準確的結果,或是盡可能快速傳回結果。Routes API 提供的選項可讓您控制回應資料品質與回應延遲時間。

設定流量資料層級

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

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

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

不支援流量

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

TRAFFIC_UNAWARE 為預設設定。

在回應中:

  • 預估抵達時間包含在 duration 回應屬性中。

  • durationstaticDuration 回應屬性包含相同的值。

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

交通感知

設定 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_AWARETRAFFIC_AWARE_OPTIMALdepartureTime 距離現在的時間越近,即時車流量的影響力就越大。您設定的出發時間越晚,系統就會越重視歷來交通狀況。

設定路徑偏好設定的範例

以下 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 要求沿著路況感知折線的路況資訊。詳情請參閱「要求多邊形線」。