asinesio/elevation-service

Web service returns elevation data for North America.

#Elevation Service

Elevation Service is a RESTFul web service that returns elevation data for any lat/long in North America.

##How it works

Elevation Service will download height files automatically from the USGS's file server, parse them, and return elevation data.

##Usage

Prerequisites: JDK 1.6 or later.

Clone the repository and change into it.

    git clone https://github.com/asinesio/elevation-service.git
    cd elevation-service

Use gradle to run the app locally:

    ./gradlew run

If all went well, the app will begin listening at http://localhost:3000.

API

elevation

Return elevation data for a given latitude/longitude. Example: http://localhost:3000/elevation/37.331789/-122.029620

Method	Response Content Types	URL Format
GET	application/json	http://localhost:3000/elevation/{latitude}/{longitude}

HTTP Status	Response	Example
200 OK	JSON object containing elevation in meters	{"elevation":100,"units":"meters"}
404 NOT FOUND	JSON object with no data	{}

Technology Stack

Elevation Service uses the following technologies:

• Java 1.6 or later
• Restlet 2.1 for the container and REST support
• Spring 3.0 for dependency injection
• Spock and Groovy for testing
• Gradle Wrapper for builds

License

This code is licensed under the MIT License and can be used freely.