Elevation Service Web API Help Page

Introduction

The RESTful elevation service allows you to retrieve the height of geographical locations. Several datasets are available, each with their own resource. The easiest way to query for data is by launching a standard HTTP GET request. Several parameters are available, such as the number of samples, or the desired coordinate system. If the list of parameters is too long to fit in the URL a POST request should be used instead.

The output can be requested in XML (application/xml) or in JSON (application/json) format by specifying the Accept header. JSON will be returned by default if the header is not specified. In the case of a POST request a Content-Type header with one of those two options is mandatory.

The accept-encoding header can be used to compress the response: Accept-Encoding: gzip, deflate.

Dataset

Handles GET requests for listing available datasets.

API	Description
GET v1/dataset	GET method to retrieve a list of available sets of data. The canonical name is included in the response, as is the GET and POST URL's required for querying for the data.

Elevation

Handles GET requests for elevation data.

API	Description
GET v1/{DatasetName}	GET method to retrieve the elevation for any number of points, as long as they fit in the URL. The points can be in any of the supported coordinate systems. The same is true for the output. If the samples parameter is present the elevation will be provided for evenly spaced points along the path indicated by the input points. Without the samples parameter only the elevation for the input points themselves will be returned.

API

Description

GET v1/{DatasetName}

GET method to retrieve the elevation for any number of points, as long as they fit in the URL. The points can be in any of the supported coordinate systems. The same is true for the output. If the samples parameter is present the elevation will be provided for evenly spaced points along the path indicated by the input points. Without the samples parameter only the elevation for the input points themselves will be returned.

ElevationRequest

Handles POST requests for elevation data.

API	Description
POST v1/{DatasetName}/request	POST method to retrieve the elevation for a number of points. The points can be in any of the supported coordinate systems. The same is true for the output. Both JSON (with GeoJSON) and XML (with GML) are supported. If the samples parameter is present the elevation will be provided for evenly spaced samples along the path indicated by the input points. Without the samples parameter only the elevation for the input points themselves will be returned.

API

Description

POST v1/{DatasetName}/request

POST method to retrieve the elevation for a number of points. The points can be in any of the supported coordinate systems. The same is true for the output. Both JSON (with GeoJSON) and XML (with GML) are supported. If the samples parameter is present the elevation will be provided for evenly spaced samples along the path indicated by the input points. Without the samples parameter only the elevation for the input points themselves will be returned.