- "html_template": " <h1 id=\"landsat\">Earth</h1> <p> Landsat imagery is provided to the public as a joint project between NASA and USGS. A recent industry <a href=\"http://www.fgdc.gov/ngac/meetings/december-2014/ngac-landsat-economic-value-paper-2014-update.pdf\">report</a> on landsat satellite imagery data estimates that total annual value to the economy of $2.19 billion, far exceeding the multi-year total cost of building, launching, and managing Landsat satellites and sensors. The value is derived from consumers <em>use</em> of the data. The objective of this endpoint is to give you an easy to use taste of what Landsat imagery data can provide. There are more complicated APIs available if you want to build models on top of satellite imagery, apply machine-learning, or minimize clouds in your image. NASA's Earth Science Devision has a variety of Earth imagery APIs for developers, which you can find out about in the <a href='https://earthdata.nasa.gov/collaborate/open-data-services-and-software/api'> Earthdata Developer Portal</a>. Specifically, the <a href='https://wiki.earthdata.nasa.gov/display/GIBS/GIBS+API+for+Developers'>GIBS</a> (Global Imagery Browse Services) API may be of interest. The <a href='https://earthengine.google.com/'>Google Earth Engine API</a> is another powerful option. This API is powered by Google Earth Engine API, and currently only supports pan-sharpened Landsat 8 imagery. </p><p><strong>Example image:</strong></p><p><img src=\"assets/img/general/houston_2.png\"/></p><p>This example image shows downtown Houston, Texas USA. It should be what is returned if you use the example query below. If you discover any cool applications, <a href='https://github.com/nasa/api-docs/issues/125'>please let us know</a>. </p><h2 id=\"imagery\">Imagery</h2> <p>This endpoint retrieves the Landsat 8 image for the supplied location and date. The response will include the date and URL to the image that is closest to the supplied date. The requested resource may not be available for the <em>exact</em> date in the request. You can retrieve a JSON that contains the inputs you provided and a URL to the resulting image through the assets endpoint. The assets endpoint no longer returns a list of potential images within your date range due to a change on the Google Earth Engine API side. </p><p>The cloud score was an optional calculation that returns the percentage of the queried image that is covered by clouds, but it is not available in current versions of the API. If <code class=\"prettyprint\">False</code> If <code class=\" </p><h3 id=\"http-request\">HTTP Request</h3> <p><code class=\"prettyprint\"> GET https://api.nasa.gov/planetary/earth/imagery </code> </p><h3 id=\"query-parameters\">Query Parameters</h3> <table> <thead> <tr> <th>Parameter</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr></thead> <tbody> <tr> <td>lat</td><td>float</td><td>n/a</td><td>Latitude</td></tr><tr> <td>lon</td><td>float</td><td>n/a</td><td>Longitude</td></tr><tr> <td>dim</td><td>float</td><td>0.025</td><td>width and height of image in degrees</td></tr><tr> <td>date</td><td>YYYY-MM-DD</td><td><em>today</em></td><td> date of image; if not supplied, then the most recent image (i.e., closest to today) is returned </td></tr><tr> <td>cloud_score</td><td>bool</td><td>False</td><td>[NOT CURRENTLY AVAILABLE!!!!] calculate the percentage of the image covered by clouds</td></tr><tr> <td>api_key</td><td>string</td><td>DEMO_KEY</td><td>api.nasa.gov key for expanded usage</td></tr></tbody> </table> <h3 id=\"example-query\">Example query</h3> <p><a href=\"https://api.nasa.gov/planetary/earth/imagery?lon=-95.33&lat=29.78&date=2018-01-01&dim=0.15&api_key=DEMO_KEY\"><code class=\"prettyprint\">https://api.nasa.gov/planetary/earth/imagery?lon=100.75&lat=1.5&date=2014-02-01&api_key=DEMO_KEY</code></a></p><aside class=\"notice\"> Note that the returned object may not match the supplied date exactly. Instead, the image closest to the supplied date is returned. </aside> <h2 id=\"assets\">Assets</h2> <p>This endpoint retrieves the date-times and asset names for closest available imagery for a supplied location and date. The satellite passes over each point on earth roughly once every sixteen days. <a href=\"//earthobservatory.nasa.gov/Features/LandsatBigData/\">This is an amazing visualization</a> of the acquisition pattern for Landsat 8 imagery. The objective of this endpoint is primarily to support the use of the <a href=\"/api.html#imagery\">imagery endpoint</a>. </p><h3 id=\"http-request\">HTTP Request</h3> <p><code class=\"prettyprint\"> GET https://api.nasa.gov/planetary/earth/assets </code> </p><h3 id=\"query-parameters\">Query Parameters</h3> <table> <thead> <tr> <th>Parameter</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr></thead> <tbody> <tr> <td>lat</td><td>float</td><td>n/a</td><td>Latitude</td></tr><tr> <td>lon</td><td>float</td><td>n/a</td><td>Longitude</td></tr><tr> <td>date</td><td>YYYY-MM-DD</td><td>n/a</td><td>beginning of 30 day date range that will be used to look for closest image to that date</td></tr><tr> <td>dim</td><td>float</td><td>0.025</td><td>width and height of image in degrees</td></tr><tr> <td>api_key</td><td>string</td><td>DEMO_KEY</td><td>api.nasa.gov key for expanded usage</td></tr></tbody> </table> <h3 id=\"example-query\">Example query</h3> <p><a href=\"https://api.nasa.gov/planetary/earth/assets?lon=100.75&lat=1.5&date=2014-02-01&dim=0.15&api_key=DEMO_KEY\"><code class=\"prettyprint\">https://api.nasa.gov/planetary/earth/assets?lon=-95.33&lat=29.78&date=2018-01-01&&dim=0.10&api_key=DEMO_KEY</code></a></p>"
0 commit comments