使用 Distance Matrix API 的好處
您可以使用 Distance Matrix API 找出多個可能起點和目的地之間的路線最有效率的行程路線。例如可將套件傳送至工作網站,或是從哪些倉儲傳送套件。
Distance Matrix API 的用途
您可以使用 Distance Matrix API 提供起點和目的地矩陣的移動距離和所需時間。您可以指定多個選項,包括交通方式 (例如開車、騎腳踏車、大眾運輸或步行),以及大眾運輸模式 (例如公車、地鐵、火車、電車或鐵路)。
Distance Matrix 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、地址或經緯度座標的形式,提供起點和目的地。 |
|
|
如何使用 Distance Matrix API
1 | 做好準備: | 從設定 Google Cloud 專案開始,並按照下文說明進行設定。 |
2 | 使用距離矩陣要求 | 取得 API 金鑰後,即可直接透過瀏覽器測試 Distance Matrix API。如需範例,請參閱開始使用指南中的「要求範例」。 |
3 | 撰寫較複雜的要求 | 請嘗試提出多個起點和目的地的要求。瞭解用來限制計算 (例如指定出發時間或路線限制) 的選用參數。請參閱距離矩陣要求和回應指南中的選用參數 。 |
4 | 瞭解回覆的基本概念 | 瀏覽資料回應,準備為應用程式使用距離矩陣資料。詳情請參閱「距離矩陣回應」一文。 |
5 | 在自己的應用程式中整合距離矩陣資料! | 您可以運用這項資料計算行程距離和時間。 |
可用的用戶端程式庫
透過下列其中一個用戶端程式庫,以您選擇的語言呼叫這個 API:
Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。從 GitHub 下載這些檔案,您也可以在其中找到安裝操作說明和程式碼範例。
後續步驟
- 開始使用距離矩陣:前往「開始使用」。
- 開始使用範例要求和回應:前往「距離矩陣要求和回應」
- 遵循最佳做法:請參閱 Web Service 最佳做法。