Distance Matrix API 總覽

Distance Matrix API 服務可接受 HTTPS 要求,其中包含指定交通方式的起點和目的地。系統會針對每個起點和目的地組合,傳回移動距離和所需時間。

使用 Distance Matrix API 的好處

您可以使用 Distance Matrix API,協助找出多個可能起點和目的地之間最有效率的行駛路線。例如,要將哪些工作站傳送至工作地點,或是要從哪些倉庫傳送套件。

Distance Matrix API 的用途

您可以使用 Distance Matrix API 提供起點和目的地矩陣的移動距離和時間。您可以指定多個選項,包括行車、單車、大眾運輸或步行等交通方式,以及公車、地鐵、火車、電車或火車。

Distance Matrix API 會根據起點與終點之間的建議路線提供資訊。您可以要求取得下列類型的距離資料:

  • 所選交通方式的距離
  • 距離 (公里或英里)
  • 預估交通時間

在地圖和 API 回應中顯示起點和目的地的地圖

Distance Matrix API 的運作方式

Distance Matrix API 會使用任意數量的起點 (起點) 和目的地,並傳回每個起點與所有要求目的地之間的距離和行程時間 (從要求的第一個起點開始),然後逐步移至下一個目的地。

舉例來說,如果要求將 A 和 B 指定為起點,並以 C 和 D 做為目的地,系統便會按照下列順序傳回距離和交通時間:

  • A 到 C
  • A 到 D
  • B 到 C
  • B 至 D

以下範例顯示兩個來源的要求:華盛頓特區和波士頓,並以 JSON 格式的單一目的地「紐約市」:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

資源

下表摘要說明透過 Distance Matrix API 取得的資源,以及其傳回的資料。

資料資源 傳回的資料 傳回格式
距離矩陣

以地點 ID、地址或經緯度座標的形式提供出發地和目的地。

  • 每個起點和每個目的地之間的距離與交通時間
  • 如果指定行車模式和出發時間,請設定車流量的所需時間
  • JSON
  • XML

如何使用 Distance Matrix API

1 做好準備。 請先設定 Google Cloud 專案,然後按照指示完成設定。
2 嘗試執行距離矩陣要求 取得 API 金鑰後,您就可以直接在瀏覽器中測試 Distance Matrix API。如需範例,請參閱開始使用指南中的「要求範例」一節。
3 編寫更複雜的要求 請嘗試要求提供多個起點和目的地。瞭解用來限制計算的選用參數,例如指定的出發時間或路線限制。請參閱距離矩陣要求和回應指南選用參數
4 瞭解回應基本知識 探索資料回應,準備好使用應用程式的距離矩陣資料。詳情請參閱「距離矩陣回應」一文。
5 在自家應用程式中整合距離矩陣資料! 這項資料可以用來計算移動距離和時間。

可用的用戶端程式庫

請透過下列其中一種用戶端程式庫,以您選擇的語言呼叫這個 API:

Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載,您也可以在此找到安裝指示和程式碼範例。

後續步驟