透過 Routes API 試用新一代的距離矩陣功能。

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 下載，也可以在這裡找到安裝操作說明和程式碼範例。

後續步驟