Compute Routes 簡介

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

簡介

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

需要 Route Matrix 嗎？如果您對路線矩陣感興趣，請參閱「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 適用的用戶端程式庫清單，請參閱「用戶端程式庫」。

後續步驟