Routes API 總覽

Routes API 服務接受 HTTPS 要求 傳回兩個地點之間的理想路線，或是距離和行程 不同起點和目的地位置之間的路線矩陣。

使用 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 可用的用戶端程式庫清單，請參閱 用戶端程式庫。

後續步驟