Compute Routes 簡介

歐洲經濟區 (EEA) 開發人員

簡介

Compute Routes 是 Routes API 服務中的方法，可接受 HTTPS 要求，並傳回兩個地點之間的理想路線。提供多個地點之間的大眾運輸、單車、開車、2 輪機動車輛或步行路線和即時路況。

需要路徑矩陣嗎？如要瞭解路線矩陣，請參閱「Compute Route Matrix 總覽」。

要遷移嗎？如要從 Distance Matrix API (舊版) 遷移，請參閱「為何要遷移至 Routes API」一文，瞭解遷移操作說明。

為何要使用 Compute Routes

透過 Compute Routes，您可以根據偏好設定，並考量成本和品質，運用各種路線詳細資料為車輛或包裹規劃路線。

Compute Routes 可提供哪些功能？

使用 Routes API Compute Routes 方法，您可以執行下列操作：

  • 取得不同交通方式的路線，以及單一或多個目的地的路線：

    • 交通方式：大眾運輸、開車、兩輪車輛、步行或騎單車。

    • 一系列路線控點，您可以最佳化這些控點的順序，找出最有效率的路線。

  • 使用多種方式指定起點、目的地和路線控點：

    • 文字字串。例如：「Chicago, IL」、「Darwin, NT, Australia」、「1800 Amphitheatre Parkway, Mountain View, CA 94043」或「CWF6+FWX Mountain View, California」

    • 地點 ID

    • 經緯度座標，可選用車輛航向

  • 根據需求和目標微調路線選項：

  • 控管延遲和品質：使用欄位遮罩只要求所需資料，避免不必要的處理時間和較高的要求計費費率。詳情請參閱「選擇要傳回的資訊」。

Compute Routes 的運作方式

Routes API ComputeRoutes 方法會接受 HTTP POST 要求，以及包含要求詳細資料的 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'

接著，這項服務會計算所要求的路線，並傳回您要求的欄位。

資源

下表摘要列出透過 Routes API Compute Routes 方法提供的資源，以及傳回的資料。

資料資源 傳回的資料 傳回格式
ComputeRoutes 傳回路線、路段和步驟，以及替代路線 (如有要求)。 JSON

如何使用 Compute Routes

1 做好準備 請先按照「設定 Google Cloud 專案」一文中的操作說明完成設定。
2 瞭解 Routes API 的計費方式 詳情請參閱「用量與計費」。
3 計算路線並檢查回應 詳情請參閱「取得路線」和「查看路線回應」。

可用的用戶端程式庫

如需 Compute Routes 適用的用戶端程式庫清單，請參閱用戶端程式庫。

後續步驟