Distance API between coordinates or countries

Straight-line kilometers between two points, or between the geographic centers of two countries.

What it does

Great-circle kilometers between two coordinates, or between the geographic centers of two countries.

POST /v1/geo/distance

Limits: Straight-line distance. No road routes or travel times.

Use cases

Estimate shipping zones.
Sort results by distance.
Show how far a visitor is from a store.

Data sources and freshness

Haversine formula on WGS84 coordinates; country centers from the countries dataset.

Computed per request.

Pricing

Every new account gets 100 free calls. Packs of 10,000 ($5), 100,000 ($15) and 250,000 calls ($29) never expire, or choose Unlimited for $39 a month. Only successful responses use a call. See pricing.

FAQ

Does it return road distance?

No. It returns the great-circle distance only, without routes or travel times.

Get 100 free calls Docs

Request

curl -X POST https://liveapi.io/v1/geo/distance \
  -H "Authorization: Bearer $LIVEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":{"country":"TR"},"to":{"country":"DE"}}'

Response

{
  "kilometers": 2421.2,
  "from": {
    "latitude": 39,
    "longitude": 35,
    "country": "TR",
    "label": "Türkiye"
  },
  "to": {
    "latitude": 51,
    "longitude": 9,
    "country": "DE",
    "label": "Almanya"
  }
}