CINXE.COM

<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta content="https://tessadem.com/bin/overview.png" property="og:image"><meta content="https://tessadem.com/bin/overview.png" name="twitter:image"><meta content="512" property="og:image:width"><meta content="439" property="og:image:height"><meta content="image/png" property="og:image:type"><meta content="width=device-width, initial-scale=1" name="viewport"><link href="https://tessadem.com/elevation-api/" rel="canonical"><script>GLOBALS={}</script><script>VERSION="202411121720"</script><script defer src="/?_path=api._js&files=templates.default%2Capps.elevationApi%2Cmodules.breadcrumb%2Cmodules.menu&version=202411121720"></script><script>appTime="61wju8e";</script><link href="/?_path=api._css&files=templates.default%2Capps.elevationApi%2Cmodules.breadcrumb%2Cmodules.menu&version=202411121720" rel="stylesheet"><meta content="index, follow" name="robots"><title>Elevation API • Easily get elevation from latitude and longitude</title><meta content="Elevation API • Easily get elevation from latitude and longitude" property="og:title"><meta content="Elevation API • Easily get elevation from latitude and longitude" name="twitter:title"><meta content="Elevation API provides 3 modes (points, path and area), 3 formats (JSON, GeoTIFF and KML) and 2 units (meters and feet) to help you converting geographic coordinates to elevation data." name="description"><meta content="Elevation API provides 3 modes (points, path and area), 3 formats (JSON, GeoTIFF and KML) and 2 units (meters and feet) to help you converting geographic coordinates to elevation data." property="og:description"><meta content="Elevation API provides 3 modes (points, path and area), 3 formats (JSON, GeoTIFF and KML) and 2 units (meters and feet) to help you converting geographic coordinates to elevation data." name="twitter:description"><meta content="en_US" property="og:locale"><meta content="https://tessadem.com/elevation-api/" property="og:url"></head><body itemscope itemtype="https://schema.org/ItemPage https://schema.org/SoftwareApplication https://schema.org/LearningResource"><div id="template"><main id="app"><nav id="moduleBreadcrumb" itemprop="breadcrumb" itemscope itemtype="https://schema.org/BreadcrumbList"><span itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><a href="/" itemprop="item"><span itemprop="name">TessaDEM</span></a><meta content="1" itemprop="position"></span> > <span itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><a href="/elevation-api/" itemprop="item"><span itemprop="name">Elevation API</span></a><meta content="2" itemprop="position"></span></nav><div id="moduleMenu" itemprop="hasPart" itemscope itemtype="https://schema.org/SiteNavigationElement"><img alt="Menu" itemprop="thumbnailUrl" src="/bin/modules/menu/burger.png"><nav><div><div itemprop="hasPart" itemscope itemtype="https://schema.org/ItemPage"><a href="/" itemprop="url"><span itemprop="name headline">TessaDEM</span></a></div><div itemprop="hasPart" itemscope itemtype="https://schema.org/ItemPage"><a href="/elevation-api/" itemprop="url"><span itemprop="name headline">Elevation API</span></a></div><div itemprop="hasPart" itemscope itemtype="https://schema.org/WebPage"><a href="/signin/?redirect=%2Fdashboard%2F" itemprop="url"><span itemprop="name headline">Sign in</span></a></div><div itemprop="hasPart" itemscope itemtype="https://schema.org/WebPage"><a href="/signup/?redirect=%2Fdashboard%2F" itemprop="url"><span itemprop="name headline">Sign up</span></a></div></div></nav></div><h1 itemprop="name headline teaches">Elevation API</h1><p itemprop="abstract">Easily <strong>get elevation from latitude and longitude</strong>.</p><div itemprop="description"><p>The most complete and useful <strong>online elevation API</strong>:</p><ul itemprop="featureList"><li><em>Elevation API</em> provides 3 modes (<em>points</em>, <em>path</em> and <em>area</em>), 3 formats (<em>JSON</em>, <em>GeoTIFF</em> and <em>KML</em>) and 2 units (<em>meters</em> and <em>feet</em>) to help you <strong>converting geographic coordinates to elevation data</strong>.</li><li><strong>Tree height is removed</strong> from the elevation data to better match the <strong>terrain elevation</strong>.</li></ul></div><section><h2>Base URL</h2><p><span class="highlight">https://tessadem.com/api/elevation?<i>parameters</i></span></p></section><section><h2>Parameters</h2><section><h3><span translate="no">key</span> <i>(required)</i></h3><p>The key that will identify you to the API.</p><p><a class="submit" href="/dashboard/">Get an API key</a></p></section><section><h3><span translate="no">mode</span> <i>(optional)</i></h3><ul><li><p><b translate="no">points</b> <i>(default value)</i></p><p>For each location provided, the corresponding elevation data will be returned.</p></li><li><p><b translate="no">path</b></p><p>Provided locations define a path along which elevation data will be returned at regular intervals.<br>The additional parameter <b translate="no">samples</b> determines the number of elevation data that must be returned.<br>The maximum number of samples per request is 2,048.</p></li><li><p><b translate="no">area</b></p><p>Provided locations define the southwest and northeast corners of an area within which elevation data will be returned at regular intervals.<br>The additional parameters <b translate="no">rows</b> and <b translate="no">columns</b> determine the number of elevation data that must be returned.<br>The maximum size of the area (i.e., rows multiplied by columns) per request is 16,384.</p></li></ul></section><section><h3><span translate="no">locations</span> <i>(required)</i></h3><p>Each location must be made up of a latitude (between -80 and 84) and a longitude, separated by a <span class="highlight">,</span><br>Locations must be separated from each other by a <span class="highlight">|</span><br>The maximum number of locations per request is 512.<br>The maximum extent of locations per request is 5° latitude by 5° longitude.</p></section><section><h3><span translate="no">format</span> <i>(optional)</i></h3><ul><li><p><b translate="no">json</b> <i>(default value)</i></p><p>Elevation data will be returned in JSON format.</p></li><li><p><b translate="no">geotiff</b> <i>(only available in area mode)</i></p><p>Elevation data will be returned in GeoTIFF format.</p></li><li><p><b translate="no">kml</b></p><p>Elevation data will be returned in KML format.</p></li></ul></section><section><h3><span translate="no">unit</span> <i>(optional)</i></h3><ul><li><p><b translate="no">meters</b> <i>(default value)</i></p><p>Elevation data will be returned in meters.</p></li><li><p><b translate="no">feet</b></p><p>Elevation data will be returned in feet.</p></li></ul></section></section><section><h2>Examples</h2><ul><li itemprop="workExample" itemscope itemtype="https://schema.org/WebContent"><p><span itemprop="description">Get the elevation data for <i>location</i> [44.690172, 4.806921] returned in <i>meters</i> as a <i>JSON</i> file</span>:</p><p><span class="highlight" itemprop="text">https://tessadem.com/api/elevation?key=KEY&locations=44.690172,4.806921</span></p></li><li itemprop="workExample" itemscope itemtype="https://schema.org/WebContent"><p><span itemprop="description">Get the elevation data for <i>locations</i> [44.690172, 4.806921] and [42.701059, 2.896646] returned in <i>feet</i> as a <i>JSON</i> file</span>:</p><p><span class="highlight" itemprop="text">https://tessadem.com/api/elevation?key=KEY&locations=44.690172,4.806921|42.701059,2.896646&unit=feet</span></p></li><li itemprop="workExample" itemscope itemtype="https://schema.org/WebContent"><p><span itemprop="description">Get 2,048 elevation data covering the <i>path</i> [46.2682, 6.0991], [44.6901, 4.8069], [42.701, 2.8966] returned in <i>meters</i> as a <i>JSON</i> file</span>:</p><p><span class="highlight" itemprop="text">https://tessadem.com/api/elevation?key=KEY&mode=path&samples=2048&locations=46.2682,6.0991|44.6901,4.8069|42.701,2.8966</span></p></li><li itemprop="workExample" itemscope itemtype="https://schema.org/WebContent"><p><span itemprop="description">Get 16,384 elevation data covering the <i>area</i> [42.701, 2.897], [46.268, 6.099] returned in <i>meters</i> as a <i>GeoTIFF</i> file</span>:</p><p><span class="highlight" itemprop="text">https://tessadem.com/api/elevation?key=KEY&mode=area&rows=128&columns=128&locations=42.701,2.897|46.268,6.099&format=geotiff</span></p></li></ul></section><section><h2>Response</h2><section><h3>Status code</h3><ul><li><b translate="no">200 OK</b>: the request was executed successfully.</li><li><b translate="no">400 Bad Request</b>: the request is malformed.</li><li><b translate="no">414 Request-URI Too Long</b>: the URL length must be less than 16,385 characters.</li><li><b translate="no">429 Too Many Requests</b>: the maximum number of 300 requests per minute has been exceeded.</li><li><b translate="no">402 Payment Required</b>: your request balance is insufficient.</li><li><b translate="no">500 Internal Server Error</b>: an unexpected error has occurred.</li></ul></section><section><h3>Headers</h3><ul><li><b translate="no">Request-Balance</b>: your request balance after the current request has been executed.</li></ul></section><section><h3>Content</h3><ul><li itemprop="workExample" itemscope itemtype="https://schema.org/WebContent"><p><b><span itemprop="name headline">Success example</span>:</b></p><div itemprop="text"><pre class="highlight" translate="no">{
 "results": [
 {
 "latitude": 44.690172,
 "longitude": 4.806921,
 "elevation": 114.11919999948627
 },
 {
 "latitude": 42.701059,
 "longitude": 2.896646,
 "elevation": 39.394957439654924
 }
 ]
}</pre><p>In <i>area</i> mode, elevation data will be returned as a 2-dimensional array representing rows and columns.</p></div></li><li itemprop="workExample" itemscope itemtype="https://schema.org/WebContent"><p><b><span itemprop="name headline">Error example</span>:</b></p><pre class="highlight" itemprop="text" translate="no">{
 "error": {
 "type": "INVALID_API_KEY",
 "message": "The API key is invalid."
 }
}</pre></li></ul></section></section><section><h2>Pricing</h2><p>€12 per 12,000 requests (€0.001 per request).</p><p>For €12 you get:</p><ul><li>Up to 6,144,000 elevation data in <i>points</i> mode.</li><li>Up to 24,576,000 elevation data in <i>path</i> mode.</li><li>Up to 196,608,000 elevation data in <i>area</i> mode.</li></ul><p><a class="submit" href="/buy/?back=%2Felevation-api%2F">Buy API requests</a></p></section></main><footer itemprop="hasPart" itemscope itemtype="https://schema.org/WPFooter"><div><span itemprop="hasPart" itemscope itemtype="https://schema.org/WebPage"><a href="/legal/" itemprop="url" rel="nofollow"><span itemprop="name headline">Legal notice</span></a></span><span>•</span><span itemprop="hasPart" itemscope itemtype="https://schema.org/TextDigitalDocument"><a href="https://tessanet.fr/terms-of-service/" itemprop="url" rel="nofollow" target="_blank"><span itemprop="name">Terms of service</span></a></span><span>•</span><span itemprop="hasPart" itemscope itemtype="https://schema.org/ContactPage"><a href="/contact/" itemprop="url" rel="nofollow"><span itemprop="name headline">Contact</span></a></span></div></footer></div></body></html>