Google Maps Distance Matrix API

Request Example

curl -XGET
https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver+BC|Las+Vegas|New+York&destinations=Boston|Arizona|San+Luiz|Detroit|San+Francisco|Washington&units=metric&mode=driving&key=YOUR_API_KEY

origins=Vancouver|Las+Vegas|New+York
destinations=Boston|Arizona|San+Luiz|Detroit|San+Francisco|Washington

Distance matrix

Matrix	Boston	Arizona	San Luis	Detroit	San Francisco	Washington
Vancouver	5,129 km	2,587 km	2,529 km	3,999 km	1,528 km	320 km
Las Vegas	4,370 km	721 km	508 km	3,239 km	917 km	1,757 km
New York	346 km	3,751 km	4,200 km	989 km	4,671 km	4,491 km

API response

https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver+BC|Las+Vegas&destinations=Boston|Arizona|San+Luiz|Detroit|San+Francisco|Washington&units=metric&mode=driving&key=YOUR_API_KEY
{
"destination_addresses": [
"Boston, MA, USA",
"Arizona, USA",
"San Luis, AZ, USA",
"Detroit, MI, USA",
"San Francisco, CA, USA",
"Washington, USA"
],
"origin_addresses": [
"Vancouver, BC, Canada",
"Las Vegas, NV, USA",
"New York, NY, USA"
],
"rows": [
{
"elements": [
{
"distance": {
"text": "5,129 km",
"value": 5129141
},
"duration": {
"text": "1 day 23 hours",
"value": 170017
},
"status": "OK"
},
{
"distance": {
"text": "2,587 km",
"value": 2587194
},
"duration": {
"text": "1 day 2 hours",
"value": 94071
},
"status": "OK"
},
{
"distance": {
"text": "2,529 km",
"value": 2529038
},
"duration": {
"text": "1 day 1 hour",
"value": 88455
},
"status": "OK"
},
{
"distance": {
"text": "3,999 km",
"value": 3998644
},
"duration": {
"text": "1 day 13 hours",
"value": 132025
},
"status": "OK"
},
{
"distance": {
"text": "1,528 km",
"value": 1528140
},
"duration": {
"text": "15 hours 10 mins",
"value": 54570
},
"status": "OK"
},
{
"distance": {
"text": "320 km",
"value": 319635
},
"duration": {
"text": "3 hours 40 mins",
"value": 13211
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"text": "4,370 km",
"value": 4369990
},
"duration": {
"text": "1 day 16 hours",
"value": 142771
},
"status": "OK"
},
{
"distance": {
"text": "721 km",
"value": 720700
},
"duration": {
"text": "7 hours 59 mins",
"value": 28739
},
"status": "OK"
},
{
"distance": {
"text": "508 km",
"value": 508382
},
"duration": {
"text": "5 hours 15 mins",
"value": 18873
},
"status": "OK"
},
{
"distance": {
"text": "3,239 km",
"value": 3239494
},
"duration": {
"text": "1 day 5 hours",
"value": 104779
},
"status": "OK"
},
{
"distance": {
"text": "917 km",
"value": 917297
},
"duration": {
"text": "8 hours 45 mins",
"value": 31513
},
"status": "OK"
},
{
"distance": {
"text": "1,757 km",
"value": 1756844
},
"duration": {
"text": "16 hours 46 mins",
"value": 60361
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"text": "346 km",
"value": 346169
},
"duration": {
"text": "3 hours 39 mins",
"value": 13132
},
"status": "OK"
},
{
"distance": {
"text": "3,751 km",
"value": 3751451
},
"duration": {
"text": "1 day 12 hours",
"value": 129207
},
"status": "OK"
},
{
"distance": {
"text": "4,200 km",
"value": 4199625
},
"duration": {
"text": "1 day 15 hours",
"value": 141039
},
"status": "OK"
},
{
"distance": {
"text": "989 km",
"value": 989373
},
"duration": {
"text": "9 hours 35 mins",
"value": 34477
},
"status": "OK"
},
{
"distance": {
"text": "4,671 km",
"value": 4670940
},
"duration": {
"text": "1 day 19 hours",
"value": 154646
},
"status": "OK"
},
{
"distance": {
"text": "4,491 km",
"value": 4490763
},
"duration": {
"text": "1 day 18 hours",
"value": 149567
},
"status": "OK"
}
]
}
],
"status": "OK"
}

Check directions

https://www.google.com/maps/dir/