---
title: "Geodesic distance between two points"
method: GET
path: "/v1/distance"
tags: ["Spatial Queries"]
---

# Geodesic distance between two points

`GET /v1/distance`

## Request

- Base URL: `https://api.terranode.co`
- URL: `https://api.terranode.co/v1/distance`
- Auth: API key in header `x-api-key`

Calculate the geodesic distance between two points on the WGS84 ellipsoid using Karney's algorithm (sub-nanometer precision). Returns distance in both meters and miles.

## Query parameters

- `lat1` number, required
- `lng1` number, required
- `lat2` number, required
- `lng2` number, required

## Response `200`

Distance result.

- DistanceResponse
  - `distance_m` number, required: Geodesic distance in meters.
  - `distance_mi` number, required: Geodesic distance in miles.
  - `latency_ms` number, required
  - `api_version` string, required
  - `semantics_version` string, required

## Other responses

- `400`: Invalid request parameters or body.
- `401`: Missing or invalid API key.
- `429`: Monthly request quota exceeded.
- `500`: Internal server error.

---

[API](https://skmtc.dev/terranode/apis/terranode-geospatial-api.md) · [All operations](https://skmtc.dev/terranode/apis/terranode-geospatial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/terranode/apis/terranode-geospatial-api/revisions/bdd80613bc7a?raw)