開始使用 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

<DistanceMatrixResponse>  <status>OK</status>  <origin_address>Washington, DC, USA</origin_address>  <destination_address>New York, NY, USA</destination_address>  <row>   <element>    <status>OK</status>    <duration>     <value>14078</value>     <text>3 hours 55 mins</text>    </duration>    <distance>     <value>367654</value>     <text>228 mi</text>    </distance>   </element>  </row> </DistanceMatrixResponse>

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