Compute Routes 簡介

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

簡介

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

需要路徑矩陣嗎？如果您對路線矩陣感興趣，請參閱「Compute Route Matrix 簡介」。

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

使用 Compute Routes 的好處

透過 Compute Routes，您可以根據各種路線詳細資料，依照偏好設定車輛或包裹的路線，同時改善成本和品質。

您可以透過運算子路做哪些事？

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

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

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

    • 一系列路線控點，可讓您針對最有效率的路線順序進行最佳化。

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

    • 文字字串。例如：「芝加哥 (IL)」、「澳洲北領地達爾文」、「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 適用的可用用戶端程式庫清單，請參閱「用戶端程式庫」。

後續步驟