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