您選取的車流量偏好設定,會透過下列兩種方式之一,平衡路線詳細資料的準確度和要求效能:
車流量監測:傳回最準確的結果 (延遲時間較長)。
不監測車流量:盡快傳回結果 (延遲時間最短)。
提出要求時,請衡量是要盡可能傳回最準確的結果,還是盡快傳回結果。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 搭配使用,要求中的元素數量 (起點數量 × 目的地數量) 會受到限制。如要進一步瞭解 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" }