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

你選取的流量偏好設定可平衡路線詳細資料的準確性 以及要求效能提出要求時,您需要衡量 建議您傳回最準確的結果 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_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 可讓您要求取得路況資訊 沿著可偵測車流量的折線。詳情請見 要求折線以取得更多資訊。