Planisfy
Api

Elevation API

Query point elevations and route elevation profiles through the configured elevation service.

Elevation API

Elevation proxies to ELEVATION_INTERNAL_URL, which Docker Compose points at the local SRTM HGT service.

Routes

MethodRouteDescription
GET/elevation/v1/{lon,lat}Elevation for one point.
GET/elevation/v1/{lon,lat;lon,lat}Elevation for up to 100 points.
GET/elevation/v1/along/{lon,lat;lon,lat}Interpolated elevation profile along a route.

Along-route parameters

ParameterNotes
samplesNumber of interpolated samples, capped at 500. Defaults to 100.
curl "https://api.example.com/elevation/v1/9.1829,48.7758" \
  -H "X-API-Key: pk_your_key_here"
curl "https://api.example.com/elevation/v1/along/9.1829,48.7758;9.2000,48.7800?samples=50" \
  -H "X-API-Key: pk_your_key_here"

Response notes

Point lookups return an elevations array and attribution. Along-route profiles return profile, summary, and attribution.

Auth, caching, and errors

Requests require API key or session auth. Successful responses cache for one day. Missing DEM coverage for an along-route profile can return 404 NO_ELEVATION_DATA.

On this page