開始使用 Distance Matrix API

要求和回應範例

這個範例會以 JSON 格式，要求華盛頓特區和紐約州紐約市之間的距離矩陣資料：

網址

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

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Washington%2C%20DC&destinations=New%20York%20City%2C%20NY&units=imperial&key=YOUR_API_KEY'

試試看！在網路瀏覽器中輸入網址，測試這項要求，請務必將 YOUR_API_KEY 換成實際的 API 金鑰。回應會顯示指定起點和目的地之間的距離和時間長度。

瞭解如何建構要求網址，包括所有可用參數。

以下是 JSON 和 XML 格式的程式碼範例：

JSON

{
  "destination_addresses": ["New York, NY, USA"],
  "origin_addresses": ["Washington, DC, USA"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "228 mi", "value": 367654 },
              "duration": { "text": "3 hours 55 mins", "value": 14078 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

XML


 OK
 Washington, DC, USA
 New York, NY, USA
 
  
   OK
   
    14078
    3 hours 55 mins
   
   
    367654
    228 mi

請參閱開發人員指南，瞭解回應。