178 lines
7.4 KiB
HTML
178 lines
7.4 KiB
HTML
|
<!DOCTYPE html>
|
||
|
|
<html class="no-js" lang="en">
|
||
|
|
|
||
|
|
<head>
|
||
|
|
<meta charset="utf-8">
|
||
|
|
<title>elevation-api.eu - Free elevation API</title>
|
||
|
|
<meta name="description" content="Free elevation api using the Copernicus dataset">
|
||
|
|
|
||
|
|
<meta http-equiv="cleartype" content="on">
|
||
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
|
||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
|
|
|
||
|
|
<link rel="stylesheet" href="css/hightlightjs-dark.css">
|
||
|
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
|
||
|
|
<link rel="preconnect" href="https://fonts.googleapis.com">
|
||
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
||
|
|
<link href="https://fonts.googleapis.com/css2?family=Roboto:ital,wght@0,300;0,400;0,500;1,300&family=Source+Code+Pro:wght@300&display=swap" rel="stylesheet">
|
||
|
|
<link rel="stylesheet" href="css/style.css" media="all">
|
||
|
|
</head>
|
||
|
|
|
||
|
|
<body class="one-content-column-version">
|
||
|
|
<div class="left-menu">
|
||
|
|
<div class="content-logo">
|
||
|
|
<div class="logo">
|
||
|
|
<img src="images/logo.png" height="32" />
|
||
|
|
<span>API Documentation</span>
|
||
|
|
</div>
|
||
|
|
<button class="burger-menu-icon" id="button-menu-mobile">
|
||
|
|
<svg width="34" height="34" viewBox="0 0 100 100"><path class="line line1" d="M 20,29.000046 H 80.000231 C 80.000231,29.000046 94.498839,28.817352 94.532987,66.711331 94.543142,77.980673 90.966081,81.670246 85.259173,81.668997 79.552261,81.667751 75.000211,74.999942 75.000211,74.999942 L 25.000021,25.000058"></path><path class="line line2" d="M 20,50 H 80"></path><path class="line line3" d="M 20,70.999954 H 80.000231 C 80.000231,70.999954 94.498839,71.182648 94.532987,33.288669 94.543142,22.019327 90.966081,18.329754 85.259173,18.331003 79.552261,18.332249 75.000211,25.000058 75.000211,25.000058 L 25.000021,74.999942"></path></svg>
|
||
|
|
</button>
|
||
|
|
</div>
|
||
|
|
<div class="mobile-menu-closer"></div>
|
||
|
|
<div class="content-menu">
|
||
|
|
<div class="content-infos">
|
||
|
|
<div class="info"><b>Version:</b> 0.8.5</div>
|
||
|
|
<div class="info"><b>Last Updated:</b> Apr. 2024</div>
|
||
|
|
</div>
|
||
|
|
<ul>
|
||
|
|
<li class="scroll-to-link active" data-target="content-get-started">
|
||
|
|
<a>GET STARTED</a>
|
||
|
|
</li>
|
||
|
|
<li class="scroll-to-link" data-target="content-get-elevation">
|
||
|
|
<a>Get Elevation</a>
|
||
|
|
</li>
|
||
|
|
<li class="scroll-to-link" data-target="content-errors">
|
||
|
|
<a>Errors</a>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
<div class="content-page">
|
||
|
|
<div class="content">
|
||
|
|
<div class="overflow-hidden content-section" id="content-get-started">
|
||
|
|
<h1>Get started</h1>
|
||
|
|
<p>
|
||
|
|
elevation-api.eu provides a free elevation service aronud the Earth's globe. Under the scenes, it uses the Copernicus DEM dataset from the European Space Agency.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<div class="overflow-hidden content-section" id="content-get-elevation">
|
||
|
|
<h2>get elevation</h2>
|
||
|
|
<p>
|
||
|
|
To get elevation (in meters, of course) of a point on earth, you need to do a GET request to the following url:<br>
|
||
|
|
<code class="higlighted break-word">https://www.elevation-api.eu/elevation/:lat/:lon</code>
|
||
|
|
<br>
|
||
|
|
Latitude and Longitude should be on the WGS-84 datum. For example, the elevation of lake Leman is:
|
||
|
|
<br>
|
||
|
|
<code>
|
||
|
|
curl https://www.elevation-api.eu/elevation/46.24566/6.17081<br>
|
||
|
|
368
|
||
|
|
</code>
|
||
|
|
</p>
|
||
|
|
<!--
|
||
|
|
<h4>QUERY PARAMETERS</h4>
|
||
|
|
<table>
|
||
|
|
<thead>
|
||
|
|
<tr>
|
||
|
|
<th>Field</th>
|
||
|
|
<th>Type</th>
|
||
|
|
<th>Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody>
|
||
|
|
<tr>
|
||
|
|
<td>secret_key</td>
|
||
|
|
<td>String</td>
|
||
|
|
<td>Your API key.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>search</td>
|
||
|
|
<td>String</td>
|
||
|
|
<td>(optional) A search word to find character by name.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>house</td>
|
||
|
|
<td>String</td>
|
||
|
|
<td>
|
||
|
|
(optional) a string array of houses:
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>alive</td>
|
||
|
|
<td>Boolean</td>
|
||
|
|
<td>
|
||
|
|
(optional) a boolean to filter alived characters
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>gender</td>
|
||
|
|
<td>String</td>
|
||
|
|
<td>
|
||
|
|
(optional) a string to filter character by gender:<br> m: male<br> f: female
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>offset</td>
|
||
|
|
<td>Integer</td>
|
||
|
|
<td>(optional - default: 0) A cursor for use in pagination. Pagination starts offset the specified offset.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>limit</td>
|
||
|
|
<td>Integer</td>
|
||
|
|
<td>(optional - default: 10) A limit on the number of objects to be returned, between 1 and 100.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
-->
|
||
|
|
</div>
|
||
|
|
<div class="overflow-hidden content-section" id="content-errors">
|
||
|
|
<h2>Errors</h2>
|
||
|
|
<p>
|
||
|
|
The elevation api uses the following error codes:
|
||
|
|
</p>
|
||
|
|
<table>
|
||
|
|
<thead>
|
||
|
|
<tr>
|
||
|
|
<th>Error Code</th>
|
||
|
|
<th>Meaning</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody>
|
||
|
|
<tr>
|
||
|
|
<td>HTTP 501</td>
|
||
|
|
<td>
|
||
|
|
The requested elevation is outside the DEM's bound. Usually this happens if you try to request a point on Sea.
|
||
|
|
You can assume the elevation to be around 0m.
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<!--
|
||
|
|
<tr>
|
||
|
|
<td>X001</td>
|
||
|
|
<td>
|
||
|
|
Unknown or unvalid <code class="higlighted">secret_key</code>. This error appears if you use an unknow API key or if your API key expired.
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>X002</td>
|
||
|
|
<td>
|
||
|
|
Unvalid <code class="higlighted">secret_key</code> for this domain. This error appears if you use an API key non specified for your domain. Developper or Universal API keys doesn't have domain checker.
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>X003</td>
|
||
|
|
<td>
|
||
|
|
Unknown or unvalid user <code class="higlighted">token</code>. This error appears if you use an unknow user <code class="higlighted">token</code> or if the user <code class="higlighted">token</code> expired.
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
-->
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
|
||
|
|
</html>
|