使用 Routes API 的好處
透過 Routes API,您可以使用運輸詳細資料、最新的車流量和道路狀況,以及路線偏好設定,取得準確的路線和行程資訊:
不同交通工具的類型和功能
車輛往的方向
需要上下車地點的道路側面
路況和道路封閉
安全性疑慮,例如避免危險區域或提供安全的接送地點
使用收費路段、行程中繼資料 (例如時間和距離與燃料效率) 等選用功能,在轉送所需的延遲時間、品質和費用之間取得平衡
也可以判斷最有效率的路徑來分派,例如:
如何指派一組 worker 來指派系列套件的最佳方式
判斷最適合的倉庫,將包裹運送至最終目的地
Routes API 提供哪些功能?
透過 Routes API,您可以取得兩種主要的轉送資訊類別:
從某個地點前往單一或多個目的地的路線
許多起點和終點之間的可能路線矩陣。
取得一或多個目的地的路線
您可以使用 Routes API Compute Routes
方法,計算不同位置之間的費用:
取得不同交通方式的路線,以及取得一或多個目的地的路線:
交通方式,包括大眾運輸、開車、機車、步行或單車。
一系列路線控點,您可以根據這些控點,找出最有效率的路線順序。
您可以透過多種方式指定起點、目的地和路線控點:
文字字串。例如:「芝加哥 (IL)」、「達爾文 (NT, 澳洲)」、「1800 Amphitheatre Parkway, Mountain View, CA 94043」或「CWF6+FWX Mountain View, California」
地點 ID
經緯度座標,可以選擇使用車輛方向
根據需求和目標微調路線選項:
請為車輛引擎類型選取燃油或節能路線:柴油、電動、油電混合、汽油。詳情請參閱「取得環保路徑」。
設定精細的流量計算選項,讓您在品質與延遲之間做出取捨。詳情請參閱「指定是否納入流量資料的方式」。
為路線控點設定車輛方向 (行進方向) 和道路側面資訊,提高預計到達時間的準確度。詳情請參閱「指定車輛方向和道路的方向」。
要求收費資訊、路線距離和預計到達時間。詳情請參閱「計算路線的通行費」。
控制延遲時間和品質:使用欄位遮罩只要求所需資料,避免不必要的處理時間和較高的請求計費率。詳情請參閱選擇要傳回的資訊。
取得可能路線的矩陣
Routes API Compute Route Matrix
方法會提供多個起點和終點之間建議路線的資訊矩陣,包括距離和預估到達時間,協助您根據業務需求選擇最佳起點和目的地。您可以要求下列類型的距離資料:
所選交通模式的距離
距離 (公里或英里)
預估交通時間
有了距離資料,您就能決定在多個可能的起點和終點之間,以最有效率的方式安排乘客、貨物或工人的路線。
在計算整個矩陣之前,您可以串流回應元素,進而縮短回應延遲時間。
每個伺服器端要求都可以指定多個起點和目的地。您可以將起點數乘以目的地數 (最多 625 個)。
Routes API 的運作方式
Routes API 有兩種方法:ComputeRoutes
和 ComputeRouteMatrix
。
ComputeRoutes
Routes API ComputeRoutes
方法接受含有 JSON 要求主體 (內含要求詳細資料) 的 HTTP POST 要求。必要欄位包括起點、目的地、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 要求主體的 HTTP POST 要求,其中包含要求詳細資料。至少須有一個起點、兩個以上的目的地、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 取得的資源,以及該 API 傳回的資料。
資料資源 | 傳回的資料 | 退貨格式 |
---|---|---|
ComputeRoutes | 傳回路線、路段和步驟,以及替代路線 (如果要求)。 | JSON |
ComputeRouteMatrix | 傳回從一個起點路線點到一個目的地路線點的路線陣列。 |
如何使用 Routes API
1 | 做好準備 | 請先參閱「設定 Google Cloud 專案」一文,並完成後續設定說明。 |
2 | 計算路徑並查看回應 | 詳情請參閱「取得路線」和「查看路線回應」。 |
3 | 計算路線矩陣並查看回應 | 詳情請參閱「取得路線矩陣」和「查看路線矩陣回應」。 |
可用的用戶端程式庫
如需 Routes API 適用的可用用戶端程式庫清單,請參閱「用戶端程式庫」。