🌐
Coordinates Distance API
Calculate the distance between any two coordinates on the map, and express the calculation in different measurement units using our Coordinates Distance API.
You need to provide your API key for every API request you make. Please refer to the Getting Started section for more details.
You can check our Errors section to understand how we handle errors and the responses you will receive in cases when errors occur.

Calculate distance (/distance)

Endpoint used for calculating the distance between two coordinates.

Request parameters

Key
Explanation
Type
Required
start
Comma-separated start coordinates.
string
true
end
Comma-separated end coordinates.
string
true
unit
Unit of length used. Default to kilometer. Accepted values are: meter, kilometer, mile.
string
false

Examples

The following example shows how to calculate the distance between any two coordinates:
GET distance?start=48.857,2.351&end=40.712,74.006
​
RESPONSE:
{
"start": {
"latitude": 48.857,
"longitude": 2.351
},
"end": {
"latitude": 40.712,
"longitude": 74.006
},
"unit": "kilometer",
"result": 5521.10621
}
If you would like to use a different length unit, you could specify the unit parameter. The following example calculates the distance between two coordinates in miles:
GET distance?start=48.857,2.351&end=40.712,74.006&unit=mile
​
RESPONSE:
{
"start": {
"latitude": 48.857,
"longitude": 2.351
},
"end": {
"latitude": 40.712,
"longitude": 74.006
},
"unit": "mile",
"result": 3430.65528
}

Response structure

Every successful response will have the structure explained in the table below:
Key
Explanation
Type
start.latitude
Latitude of the start point of calcution.
number
start.longitude
Longitude of the start point of calcution.
number
end.latitude
Latitude of the end point of calcution.
number
end.longitude
Longitude of the end point of calcution.
number
unit
Indicates which lenth unit was used for the calculation.
string
result
Represents the distance between two specified coordinates, expressed in the specified length unit.
number
​
Copy link
On this page
Calculate distance (/distance)
Request parameters
Examples
Response structure