Get started with the Distance Matrix API

Sample request and response

This example requests the distance matrix data between Washington, DC and New York City, NY, in JSON format:

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

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

Try it!Test this request by entering the URL into your web browser - be sure to replaceYOUR_API_KEYwithyour actual API key. The response shows the distance and duration between the specified origins and destinations.

Learn how tobuild request URLs, including all available parameters.

This code sample is in JSON and XML formats:

{
"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",
}

<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>

Check the developer's guide tounderstand the response.