Distance Matrix API (舊版) 總覽

歐洲經濟區 (EEA) 開發人員

簡介

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 下載，該處也提供安裝操作說明和程式碼範例。

後續步驟