GIBS API Update point#3

Author: Brazda, Tessa M. (JSC-IO111)[EAST2]

assets/html/header.html

@@ -39,7 +39,7 @@
 
     <section class="alert">
       <span class="closebtn" onclick="this.parentElement.style.display='none';">&times;</span>
-      <strong>⚠ Please Note:</strong> This Earth API will be archived and replaced with <a href="https://www.earthdata.nasa.gov/">https://www.earthdata.nasa.gov/</a> soon. Please update your bookmarks or projects as needed.
+      <strong>⚠ Please Note:</strong> The Earth API has been archived and replaced with <a href="https://api.nasa.gov/#gibs">Earth Data GIBS API</a>. Please update your bookmarks or projects as needed.
     </section>
 
     <div class="usa-nav-container">

assets/img/general/US_nighttime_lights.jpg

@@ -190,15 +190,15 @@
   },
   {
     "id": "1",
-    "name": "Earth",
-    "summary": "Unlock the significant public investment in earth observation data",
+    "name": "GIBS",
+    "summary": "Standardized web services that deliver global, full-resolution satellite imagery, enabling interactive exploration of Earth.",
     "tags": [
       "tags1",
       "tags2",
       "tags3",
       "tags4"
     ],
-    "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&amp;lat=29.78&amp;date=2018-01-01&amp;dim=0.15&amp;api_key=DEMO_KEY\"><code class=\"prettyprint\">https://api.nasa.gov/planetary/earth/imagery?lon=100.75&amp;lat=1.5&amp;date=2014-02-01&amp;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&amp;lat=1.5&amp;date=2014-02-01&amp;dim=0.15&amp;api_key=DEMO_KEY\"><code class=\"prettyprint\">https://api.nasa.gov/planetary/earth/assets?lon=-95.33&amp;lat=29.78&amp;date=2018-01-01&amp;&dim=0.10&amp;api_key=DEMO_KEY</code></a></p>"
+    "html_template": " <h1 id=\"landsat\">Global Imagery Browse Services (GIBS) </h1> <p>  NASA's Global Imagery Browse Services (<a href='https://www.earthdata.nasa.gov/engage/open-data-services-software/earthdata-developer-portal/gibs-api'>GIBS</a>) are designed to deliver global, full-resolution satellite imagery to users in a highly responsive manner, enabling visual discovery of scientific phenomena, supporting timely decision-making for natural hazards, educating the next generation of scientists, and making imagery of the planet more accessible to the media and public. GIBS provides quick access to over 1,000 satellite imagery products, covering every part of the world. Most imagery is updated daily - available within a few hours after satellite observation, and some products span almost 30 years. The satellite imagery can be rendered in your own web client or GIS application. Browse these visualizations through our <a href ='https://worldview.earthdata.nasa.gov/'>Worldview</a> application, and see the <a href='https://www.earthdata.nasa.gov/news/worldview-image-archive'>Worldview Image of the Week archive</a> to learn how these visualizations can be used. GIBS and Worldview are part of the <a href='https://www.earthdata.nasa.gov/'>Earth Science Data Systems Program</a> which provides open access to NASA’s archive of Earth science data.   </p> <p>GIBS provides access through four mechanisms: </p><ul> <li>An Open Geospatial Consortium (OGC) Web Map Tile Service (WMTS) that supports key-value-pair and Representational State Transfer (REST)ful tiled requests</li> <li>An OGC Web Map Service (WMS) that supports a key-value-pair non-tiled requests</li> <li>A Tiled Web Map Service (TWMS), an unofficial extension to the OGC WMS, that supports key-value-pair tiled requests that match the exact geographic tile boundaries</li> <li>Script-level access through the Geospatial Data Abstraction Library (GDAL)</li> </ul> <p>Imagery is provided in several map projections: </p> <ul> <li>Geographic / Equirectangular (EPSG:4326)</li> <li>Web Mercator (EPSG:3857)</li> <li>Arctic Polar Stereographic (EPSG:3413)</li> <li>Antarctic Polar Stereographic (EPSG:3031)</li> </ul> <p>Access to GIBS via the protocols above is explained in the links below. In addition, source code for the GIBS tiled imagery server and tiled imagery storage format is also available.</p> <ul><li><a href='https://nasa-gibs.github.io/gibs-api-docs/'>GIBS API for Developers</a></li> <li><a href='https://nasa-gibs.github.io/gibs-api-docs/available-visualizations/#visualization-product-catalog'> GIBS Visualization Product Catalog</a></li> <li><a href='https://nasa-gibs.github.io/gibs-api-docs/gis-usage/'>Geographic Information System (GIS) Usage</a></li> <li><a href='https://nasa-gibs.github.io/gibs-api-docs/map-library-usage/'>Map Library Usage</a></li> <li><a href='https://github.com/nasa-gibs/gibs-web-examples'>Source Code and Live Examples of GIBS Demo Clients</a></li></ul> <p><strong>Sample visualizations:</strong></p><p><img src=\"assets/img/general/global_suomi_NPP.png\"/></p><p><a href='https://worldview.earthdata.nasa.gov/?v=-265.59765955813896,-143.60737116603906,186.63761513999117,132.96626790554467&l=Reference_Labels_15m(hidden),Reference_Features_15m(hidden),Coastlines_15m(hidden),VIIRS_NOAA20_CorrectedReflectance_TrueColor(hidden),VIIRS_SNPP_CorrectedReflectance_TrueColor,MODIS_Aqua_CorrectedReflectance_TrueColor(hidden),MODIS_Terra_CorrectedReflectance_TrueColor(hidden)&lg=true&t=2024-03-16-T21%3A11%3A38Z'>Global Suomi NPP / VIIRS Corrected Reflectance from 2024 March 16</a></p> <p><img src=\"assets/img/general/harmonized_landsat_sentinel-2.png\"/></p><p><a href='https://worldview.earthdata.nasa.gov/?v=54.6035527847883,24.770385014497798,55.63446196112994,25.395336458826293&l=Reference_Labels_15m(hidden),Reference_Features_15m(hidden),Coastlines_15m(hidden),HLS_S30_Nadir_BRDF_Adjusted_Reflectance(hidden),HLS_L30_Nadir_BRDF_Adjusted_Reflectance,VIIRS_NOAA20_CorrectedReflectance_TrueColor(hidden),VIIRS_SNPP_CorrectedReflectance_TrueColor(hidden),MODIS_Aqua_CorrectedReflectance_TrueColor(hidden),MODIS_Terra_CorrectedReflectance_TrueColor(hidden)&lg=true&t=2023-11-27-T21%3A11%3A44Z'>Harmonized Landsat Sentinel-2 Reflectance of Dubai, UAE from 2023 November 27</a></p> <p><img src=\"assets/img/general/US_nighttime_lights.jpg\"/></p><p><a href='https://worldview.earthdata.nasa.gov/?v=-136.79031479180293,5.904366166378928,-64.81047312001675,55.412452389412344&l=Reference_Labels_15m(hidden),Reference_Features_15m(hidden),Coastlines_15m,VIIRS_NOAA20_DayNightBand_At_Sensor_Radiance,VIIRS_NOAA20_DayNightBand_AtSensor_M15(hidden),VIIRS_SNPP_CorrectedReflectance_TrueColor(hidden)&lg=true&t=2025-06-22-T20%3A19%3A34Z'>US Nighttime lights imagery from NOAA-20 / VIIRS Black Marble, 2025 June 22</a></p> <p><img src=\"assets/img/general/cyclone_jasper.png\"/></p><p><a href='https://worldview.earthdata.nasa.gov/?v=95.33363635096246,-44.95571703178746,166.20094325865375,-1.9949724540757572&l=Reference_Labels_15m(hidden),Reference_Features_15m,Coastlines_15m(hidden),IMERG_Precipitation_Rate,VIIRS_SNPP_DayNightBand_ENCC(hidden),VIIRS_SNPP_DayNightBand_At_Sensor_Radiance(hidden),VIIRS_SNPP_DayNightBand_AtSensor_M15(hidden),BlueMarble_NextGeneration(hidden),VIIRS_NOAA20_CorrectedReflectance_TrueColor(hidden),VIIRS_SNPP_CorrectedReflectance_TrueColor,MODIS_Aqua_CorrectedReflectance_TrueColor(hidden),MODIS_Terra_CorrectedReflectance_TrueColor&lg=true&t=2023-12-13-T00%3A00%3A00Z'>Precipitation from Tropical Cyclone Jasper on 2023 December 13 </a></p>" 
   },
   {
     "id": "1",