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 使用的資源，以及該 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 下載這些套件，也可以找到安裝操作說明和程式碼範例。

後續步驟