Skip to content

intUnderflow/opentopodata

 
 

Repository files navigation

Open Topo Data

Documentation: www.opentopodata.org

Open Topo Data is a REST API server for your elevation data. You can self-host with your own dataset or use the free public API. The API is largely compatible with the Google Maps Elevation API.

Host your own

Install docker and git then run:

git clone git@github.com:ajnisbet/opentopodata.git
cd opentopodata
make build
make run
curl http://localhost:5000/v1/test-dataset?locations=56.35,123.90
{
    "results": [{
        "elevation": 815.0,
        "location": {
            "lat": 56.0,
            "lng": 123.0
        }
    }],
    "status": "OK"
}

See the server docs for more about configuration and adding datasets.


Public API

I'm hosting a free public API at api.opentopodata.org.

curl https://api.opentopodata.org/v1/srtm30m?locations=57.688709,11.976404
{
  "results": [
    {
      "elevation": 55.0, 
      "location": {
        "lat": 57.688709, 
        "lng": 11.976404
      }
    }
  ], 
  "status": "OK"
}

The following datasets are available on the public API:

See the API docs for more about request formats and parameters.


Support

Want help getting Open Topo Data running? Send me an email at andrew@opentopodata.org.

About

Open alternative to the Google Elevation API!

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 96.6%
  • Dockerfile 2.0%
  • Makefile 1.3%
  • Shell 0.1%