開始使用

Google Maps Distance Matrix API 是一項根據起點與終點之間的建議路線，為起點與終點矩陣提供旅行距離與時間的服務。

此服務也以用戶端 Google Maps JavaScript API 之一部分的方式提供，或是搭配 Java Client、Python Client、Go Client 與 Node.js Client for Google Maps Services 針對伺服器端使用。

範例要求與回應

您可以透過 HTTP 介面搭配以建構為網址字串的要求，使用 origins 和 destinations 以及 API 金鑰，來存取 Google Maps Distance Matrix API。

下列範例以 JSON 格式要求查詢華盛頓哥倫比亞特區和紐約州紐約市之間的距離矩陣資料：

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=Washington,DC&destinations=New+York+City,NY&key=YOUR_API_KEY

嘗試一下！測試的方法是在網頁瀏覽器輸入網址（請務必使用您的實際 API 金鑰取代 YOUR_API_KEY）。回應包含指定起點與目的地之間的距離和時間。

查看開發人員指南，瞭解建置要求網址與可用參數的詳細資訊以及瞭解回應。

下面是 JSON 格式的範例回應：

{
   "destination_addresses" : [ "New York, NY, USA" ],
   "origin_addresses" : [ "Washington, DC, USA" ],
   "rows" : [
      {
         "elements" : [
            {
               "distance" : {
                  "text" : "225 mi",
                  "value" : 361715
               },
               "duration" : {
                  "text" : "3 hours 49 mins",
                  "value" : 13725
               },
               "status" : "OK"
            }
         ]
      }
   ],
   "status" : "OK"
}

開始使用我們的用戶端程式庫進行編碼

用戶端程式庫透過提供常見工作之簡易、原生的實作（例如驗證、要求節流與自動重試），使利用 Google 地圖 Web 服務 API 進行開發的工作變得更輕鬆。Google Maps Distance Matrix API 可從 Java Client、Python Client、Go Client 與 Node.js Client for Google Maps Services 取得。

驗證、配額與政策

啟用 API 及取得 API 金鑰

若要使用 Google Maps Distance Matrix API，您必須先在 Google API Console 中啟用 API 並取得正確的驗證憑證。您必須在每個要求中提供 API 金鑰 （或如果您有進階方案，則必須提供用戶端編號）。

按一下下面的按鈕以依序操作整個程序，您將能夠：

1. 建立或選取專案
2. 啟用 API
3. 取得 API 金鑰

取得金鑰

深入瞭解驗證憑證。

配額

查看使用限制頁面，了解為 Google Maps Distance Matrix API 設定之配額的詳細資料。

政策

使用 Google Maps Distance Matrix API 時必須符合 API 政策。

深入瞭解

使用 Distance Matrix API 還可以執行其他工作，例如針對不同旅行模式要求距離資料、以不同單位（例如公里或英哩）要求距離資料，和估算交通時間。請參閱 Distance Matrix API 開發人員指南，了解更多範例與其他詳細資訊。