使用 Routes API 的好處
運用 Routes API,取得準確的路線和行程資訊 提供大眾運輸詳細資料、最新路況、路況資訊以及路線 偏好設定:
不同交通方式的類型和功能
車輛往的方向
需要上下車地點的道路側面
路況和道路封閉
安全疑慮,例如避開危險區域或提供安全上車服務 區域
您可以選擇是否針對轉送需求,在延遲時間、品質和費用之間取得平衡 功能,例如收費站和行程中繼資料,例如時間和距離、燃料 效率
您也能判斷最快速的派遣路線,例如 為:
如何指派一組 worker 來指派系列套件的最佳方式
判斷最適合將包裹運送至最終目的地的倉庫
Routes API 的用途
Routes API 提供兩種主要的轉送類別 每個 ACL 都由一或多個項目組成 而這些項目包含兩項資訊
從某個位置到一或多個目的地的路徑
許多起點和終點之間的可能路徑矩陣。
取得一或多個目的地的路線
透過 Routes API Compute Routes
方法
計算不同位置:
取得各種交通方式的路線,以及單一或多個地點的路線 目的地:
交通方式,包括大眾運輸、開車、機車, 以及步行或騎單車。
一連串的路線控點,您可以進行最佳化以最有效率的訂單
您可以透過多種方式指定起點、目的地和路線控點:
文字字串。例如:「芝加哥, 伊利諾州」、「達爾文, NT, 澳大利亞」、 「1800 Amphitheatre Parkway, Mountain View, CA 94043, USA」或「CWF6+FWX Mountain 查看加州」
地點 ID
經緯度座標,可以選擇使用車輛方向
根據需求和目標微調路線選項:
為車輛的引擎類型選取燃油或節能路線: 柴油、電動、油電混合、天然氣。若需更多資訊,請參閲 取得環保路徑。
設定精細的流量計算選項,藉此改善流量品質 並在決策過程中取捨詳情請參閱 指定如何納入流量資料以及是否要納入流量資料。
設定車輛方向 (交通方向) 和道路側面資訊,以供 來提高預計到達時間的準確度。詳情請參閱 指定車輛方向和道路的方向。
要求取得收費路段資訊、路線距離和預計到達時間。詳情請參閱「計算路線的通行費」。
控管延遲時間和品質,只要求使用 欄位遮罩,有助於避免不必要的處理時間,以及提高作業效率 要求計費費率詳情請參閱 選擇要傳回的資訊。
取得可能路徑的矩陣
Routes API Compute Route Matrix
方法提供了
多個起點與終點之間的建議路線資訊矩陣
點 (包含距離和預估抵達時間) 協助您選擇
根據你的資料,推測出最佳出發地和目的地
業務需求您可以要求取得以下類型的距離資料:
所選交通方式的距離
距離 (公里或英里)
預估交通時間 (以流量為準)
參考距離資料,就能判斷最快的行進方式 乘客、貨物或工作人員之間的距離
您可以在整個矩陣發生前串流回應元素 因此能縮短回應延遲時間
您可以使用含有 出發地數量乘以目的地數量 (最多 625 個)。
Routes API 的運作方式
Routes API 有兩種方法:ComputeRoutes
和
ComputeRouteMatrix
。
ComputeRoutes
Routes API ComputeRoutes
方法接受含有
包含要求詳細資料的 JSON 要求主體。必須提供來源
目的地、travelMode 和欄位遮罩來指定要傳回的欄位。
範例
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
接著,服務會計算要求的路線,並傳回 。
ComputeRouteMatrix
Routes API ComputeRouteMatrix
接受
包含要求詳細資料的 JSON 要求主體。至少須提供一項
起點、兩個以上的目的地、travelMode 和欄位遮罩,以指定
要傳回的欄位。
範例
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
回應包含所有起點的組合可能的路徑 和目的地路線控點
資源
下表摘要說明您可以透過 Routes API 及其傳回的資料。
資料資源 | 傳回的資料 | 退貨格式 |
---|---|---|
ComputeRoutes | 傳回包含替代路線的路線、路段和步驟, 如果系統要求的話 | JSON |
ComputeRouteMatrix | 傳回從一個起點路線控點到一個目的地的路線陣列 路點。 |
如何使用 Routes API
1 | 做好準備 | 先從設定 Google Cloud 專案開始 然後按照畫面上的設定指示操作 |
2 | 計算路徑並查看回應 | 詳情請參閱「取得路線」和「查看路線回應」。 |
3 | 計算路徑矩陣並查看回應 | 詳情請參閱取得路徑矩陣 和檢視路徑矩陣回應。 |
可用的用戶端程式庫
如需 Routes API 可用的用戶端程式庫清單,請參閱 用戶端程式庫。