Distance Matrix API

The Distance Matrix API returns the driving distance between multiple pairs of origins and destinations. It’s ideal for logistics, routing, dispatch planning, and delivery network optimization.

It supports up to 3 origin points and 3 destination points, forming a maximum 3x3 matrix. Each cell in the matrix contains the driving distance for that specific origin-destination pair.

Try it out in our playground Now!

🔑 Authentication

All requests must include your API key.
Header Example:
Authorization: X-Authorization-Token (Get your token HERE)

🌐 Endpoint

GET /v4/distancematrix
Base URL: https://apihub.latlong.ai/v4/distancematrix

📥 Request Parameters

Parameter	Type	Required	Description
Origins	String	Yes	Pipe-separated list of lat,lng pairs. Max 3 origins
Destinations	String	Yes	Pipe-separated list of lat,lng pairs. Max 3 destinations

📤 Sample Request

curl --location 'https://apihub.latlong.ai/v4/distancematrix.json?origins=19.4210814%2C72.8167569%20%7C%2019.09574%2C72.8746%20%7C%2019.1634518%2C72.9296933&destinations=19.06576709%2C73.00164192%7C%2019.0958737%2C72.8401187%20%7C%2019.12428%2C73.00588'

📦 Sample Response

 { 

  "code": 1001, 

  "status": "success", 

  "data": [ 

    { 

      "origin": "19.4210814,72.8167569", 

      "destination": "19.06576709,73.00164192", 

      "distance": "60.89 km" 

    }, 

    { 

      "origin": "19.4210814,72.8167569", 

      "destination": "19.0958737,72.8401187", 

      "distance": "50.21 km" 

    }, 

    { 

      "origin": "19.4210814,72.8167569", 

      "destination": "19.12428,73.00588", 

      "distance": "51.83 km" 

    }, 

    { 

      "origin": "19.09574,72.8746", 

      "destination": "19.06576709,73.00164192", 

      "distance": "23.11 km" 

    }, 

    { 

      "origin": "19.09574,72.8746", 

      "destination": "19.0958737,72.8401187", 

      "distance": "6.04 km" 

    }, 

    { 

      "origin": "19.09574,72.8746", 

      "destination": "19.12428,73.00588", 

      "distance": "23.14 km" 

    }, 

    { 

      "origin": "19.1634518,72.9296933", 

      "destination": "19.06576709,73.00164192", 

      "distance": "20.31 km" 

    }, 

    { 

      "origin": "19.1634518,72.9296933", 

      "destination": "19.0958737,72.8401187", 

      "distance": "19.24 km" 

    }, 

    { 

      "origin": "19.1634518,72.9296933", 

      "destination": "19.12428,73.00588", 

      "distance": "11.24 km" 

    } 

  ] 

}

✅ Matrix Rules

A maximum of 3 origin points and 3 destination points
Format: "lat1, lng1 | lat2, lng2 | lat3, lng3 "
Every origin will be paired with every destination

🧠 Features

🚚
Multi-drop delivery planning and optimization
🚕
Taxi fare or ETA matrix for ride-sharing platforms
🛍️
Nearest store or warehouse lookup for a group of users
📦
Dispatching vehicles to multiple drop points

⚠️ Errors

Status Code	Message	Description
400	Missing required parameters	When query is not provided
401	Unauthorized	API key missing or invalid
500	Internal Server Error	Something went wrong on our side