Elevation API¶

Easy To Integrate Maps & Location APIs & SDKs For Web & Mobile Applications

Powered with India's most comprehensive and robust mapping functionalities. Now Available for Srilanka, Nepal, Bhutan, Bangladesh and Myanmar

You can get your api key to be used in this document here: https://about.mappls.com/api/

Introduction¶

The Elevation API provides elevation data above the sea level for location on Earth’s surface. The Elevation API allows you to retrieve sampled elevation data along a path. This API can be useful for biking, trucking & in other routing applications.

Getting Access¶

Before using the API in the your solution, please ensure that the related access is enabled in the Mappls Console, within your app - be it for Mobile OR Web or Cloud integration.

Copy and paste the key from your credentials section from your API keys into the access_token query parameter.
- Your static key can be secured by whitelisting its usage for particular IPs (in case of cloud app usage) OR a set of domains (in case of a web app)
- Your static key obtained from your Console is to be passed as a query parameter: access_token.

Authentication Object - `access_token` mandatory query parameter.¶

access_token: "hklmgbwzrxncdyavtsuojqpiefrbhqplnm".

Input Method¶

GET

Input URL¶

https://tile.mappls.com/map/bhuvan_imagery/elevation?locations=lat1,lon1|lat2,lon2&access_token=hklmgbwzrxncdyavtsuojqpiefrbhqplnm

Response Type¶

JSON: Response will served as JSON

Response Codes¶

200: To denote a successful API call.
204: DB Connection error.
400: Bad Request, User made an error while creating a valid request.
401: Unauthorized, Developer’s key is not allowed to send a request.
403: Forbidden, Developer’s key has hit its daily/hourly limit or IP or domain not white-listed.
404: HTTP not found
412: Precondition Failed, i.e. Mandatory parameter is missing
500: Internal Server Error, the request caused an error in our systems.
503: Service Unavailable, during our maintenance break or server down-times.

Request Parameters¶

Mandatory Parameters¶

locations: The location coordinates are expressed in pairs of (latitude,longitude|latitude,longitude).
REST_KEY: The REST API licence key allocated to you by signing into our services and registering yourself as a developer (28 Char Alphanumeric).

Sample Input¶

https://tile.mappls.com/map/bhuvan_imagery/elevation?locations=9.538350,76.998825|8.930019,76.655587&access_token=hklmgbwzrxncdyavtsuojqpiefrbhqplnm

Sample Response¶

{
    "responseCode": 200,
    "version": "211.18",
    "results": [
        {
            "longitude": 76.998825,
            "latitude": 9.53835,
            "elevation": 523
        },
        {
            "longitude": 76.655587,
            "latitude": 8.930019,
            "elevation": 31
        }
    ]
}

For any queries and support, please contact:

Email us at apisupport@mappls.com

Support Need support? contact us!