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

後續步驟