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 用戶端 服務是社群支援的用戶端程式庫，並採用 Apache 2.0 授權。 從 GitHub 下載這些檔案，您也可以在其中找到安裝操作說明和程式碼範例。

後續步驟