fix: update Raster api tilejson url for additional datasets

Author: kdl0013

user-guide/notebooks/datasets/air-quality-covid.ipynb

@@ -36,7 +36,7 @@
     "## Approach\n",
     "\n",
     "   1. Identify available dates and temporal frequency of observations for a given collection - NO₂\n",
-    "   2. Pass the STAC item into raster API `/stac/tilejson.json` endpoint\n",
+    "   2. Pass the STAC item into raster API `collections` endpoint\n",
     "   3. We'll visualize two tiles (side-by-side) allowing for comparison of each of the time points using `folium.plugins.DualMap`\n",
     "   "
    ]
@@ -71,7 +71,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -81,7 +81,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -95,67 +95,9 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "{'id': 'no2-monthly',\n",
-       " 'type': 'Collection',\n",
-       " 'links': [{'rel': 'items',\n",
-       "   'type': 'application/geo+json',\n",
-       "   'href': 'https://openveda.cloud/api/stac/collections/no2-monthly/items'},\n",
-       "  {'rel': 'parent',\n",
-       "   'type': 'application/json',\n",
-       "   'href': 'https://openveda.cloud/api/stac/'},\n",
-       "  {'rel': 'root',\n",
-       "   'type': 'application/json',\n",
-       "   'href': 'https://openveda.cloud/api/stac/'},\n",
-       "  {'rel': 'self',\n",
-       "   'type': 'application/json',\n",
-       "   'href': 'https://openveda.cloud/api/stac/collections/no2-monthly'}],\n",
-       " 'title': 'NO₂',\n",
-       " 'assets': {'thumbnail': {'href': 'https://thumbnails.openveda.cloud/no2--dataset-cover.jpg',\n",
-       "   'type': 'image/jpeg',\n",
-       "   'roles': ['thumbnail'],\n",
-       "   'title': 'Thumbnail',\n",
-       "   'description': 'Photo by [Mick Truyts](https://unsplash.com/photos/x6WQeNYJC1w) (Power plant shooting steam at the sky)'}},\n",
-       " 'extent': {'spatial': {'bbox': [[-180.0, -90.0, 180.0, 90.0]]},\n",
-       "  'temporal': {'interval': [['2016-01-01T00:00:00+00:00',\n",
-       "     '2022-12-31T00:00:00+00:00']]}},\n",
-       " 'license': 'MIT',\n",
-       " 'renders': {'dashboard': {'bidx': [1],\n",
-       "   'title': 'VEDA Dashboard Render Parameters',\n",
-       "   'assets': ['cog_default'],\n",
-       "   'rescale': [[0, 15000000000000000]],\n",
-       "   'resampling': 'bilinear',\n",
-       "   'color_formula': 'gamma r 1.05',\n",
-       "   'colormap_name': 'rdbu_r'}},\n",
-       " 'providers': [{'url': 'https://disc.gsfc.nasa.gov/',\n",
-       "   'name': 'NASA Goddard Earth Sciences Data and Information Services Center',\n",
-       "   'roles': ['producer', 'processor']},\n",
-       "  {'url': 'https://www.earthdata.nasa.gov/dashboard/',\n",
-       "   'name': 'NASA VEDA',\n",
-       "   'roles': ['host']}],\n",
-       " 'summaries': {'datetime': ['2016-01-01T00:00:00Z', '2023-09-30T00:00:00Z']},\n",
-       " 'description': 'Darker colors indicate higher nitrogen dioxide (NO₂) levels and more activity. Lighter colors indicate lower levels of NO₂ and less activity. Missing pixels indicate areas of no data most likely associated with cloud cover or snow.',\n",
-       " 'item_assets': {'cog_default': {'type': 'image/tiff; application=geotiff; profile=cloud-optimized',\n",
-       "   'roles': ['data', 'layer'],\n",
-       "   'title': 'Default COG Layer',\n",
-       "   'description': 'Cloud optimized default layer to display on map'}},\n",
-       " 'stac_version': '1.0.0',\n",
-       " 'stac_extensions': ['https://stac-extensions.github.io/item-assets/v1.0.0/schema.json',\n",
-       "  'https://stac-extensions.github.io/render/v1.0.0/schema.json'],\n",
-       " 'dashboard:is_periodic': True,\n",
-       " 'dashboard:time_density': 'month'}"
-      ]
-     },
-     "execution_count": 3,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
+   "outputs": [],
    "source": [
     "#Fetch STAC collection\n",
     "collection = requests.get(f\"{STAC_API_URL}/collections/{collection_name}\").json()\n",
@@ -167,22 +109,14 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Examining the contents of our `collection` under `summaries` we see that the data is available from January 2015 to December 2022. By looking at the `dashboard:time density` we observe that the periodic frequency of these observations is monthly. "
+    "Examining the contents of our `collection` under `summaries` we see that the data is available from January 2015 to September 2023. By looking at the `dashboard:time density` we observe that the periodic frequency of these observations is monthly. "
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Found 93 items\n"
-     ]
-    }
-   ],
+   "outputs": [],
    "source": [
     "# Check total number of items available\n",
     "items = requests.get(f\"{STAC_API_URL}/collections/{collection_name}/items?limit=100\").json()[\"features\"]\n",
@@ -194,14 +128,14 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "This makes sense as there are 7 years between 2016 - 2022, with 12 months per year, meaning 84 records in total.  \n",
+    "This makes sense as there are 8 years between 2016 - 2023, with 12 months per year, meaning 96 possible records. Since our dataset ends in September, we subtract 3 months to give us a total of 93 items.\n",
     "\n",
     "Below, we'll provide the max range of values to apply to visualizations of all items in the collection (`rescale_values`). "
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -223,7 +157,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -241,30 +175,12 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "{'tilejson': '2.2.0',\n",
-       " 'version': '1.0.0',\n",
-       " 'scheme': 'xyz',\n",
-       " 'tiles': ['https://openveda.cloud/api/raster/stac/tiles/WebMercatorQuad/{z}/{x}/{y}@1x?collection=no2-monthly&item=OMI_trno2_0.10x0.10_202002_Col3_V4.nc&assets=cog_default&color_formula=gamma+r+1.05&colormap_name=cool&rescale=-1018382487283302%2C50064805976866816'],\n",
-       " 'minzoom': 0,\n",
-       " 'maxzoom': 24,\n",
-       " 'bounds': [-180.0, -90.0, 180.0, 90.0],\n",
-       " 'center': [0.0, 0.0, 0]}"
-      ]
-     },
-     "execution_count": 7,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
+   "outputs": [],
    "source": [
     "february_2020_tile = requests.get(\n",
-    "    f\"{RASTER_API_URL}/stac/tilejson.json?collection={items['2020-02']['collection']}&item={items['2020-02']['id']}\"\n",
+    "    f\"{RASTER_API_URL}/collections/{items['2020-02']['collection']}/items/{items['2020-02']['id']}/WebMercatorQuad/tilejson.json?\"\n",
     "    \"&assets=cog_default\"\n",
     "    \"&color_formula=gamma+r+1.05&colormap_name=cool\"\n",
     "    f\"&rescale={rescale_values['min']},{rescale_values['max']}\", \n",
@@ -274,30 +190,12 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 8,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "{'tilejson': '2.2.0',\n",
-       " 'version': '1.0.0',\n",
-       " 'scheme': 'xyz',\n",
-       " 'tiles': ['https://openveda.cloud/api/raster/stac/tiles/WebMercatorQuad/{z}/{x}/{y}@1x?collection=no2-monthly&item=OMI_trno2_0.10x0.10_202202_Col3_V4.nc&assets=cog_default&color_formula=gamma+r+1.05&colormap_name=cool&rescale=-1018382487283302%2C50064805976866816'],\n",
-       " 'minzoom': 0,\n",
-       " 'maxzoom': 24,\n",
-       " 'bounds': [-180.0, -90.0, 180.0, 90.0],\n",
-       " 'center': [0.0, 0.0, 0]}"
-      ]
-     },
-     "execution_count": 8,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
+   "outputs": [],
    "source": [
     "february_2022_tile = requests.get(\n",
-    "    f\"{RASTER_API_URL}/stac/tilejson.json?collection={items['2022-02']['collection']}&item={items['2022-02']['id']}\"\n",
+    "    f\"{RASTER_API_URL}/collections/{items['2022-02']['collection']}/items/{items['2022-02']['id']}/WebMercatorQuad/tilejson.json?\"\n",
     "    \"&assets=cog_default\"\n",
     "    \"&color_formula=gamma+r+1.05&colormap_name=cool\"\n",
     "    f\"&rescale={rescale_values['min']},{rescale_values['max']}\", \n",
@@ -319,158 +217,9 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 9,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/html": [
-       "<div style=\"width:100%;\"><div style=\"position:relative;width:100%;height:0;padding-bottom:60%;\"><span style=\"color:#565656\">Make this Notebook Trusted to load map: File -> Trust Notebook</span><iframe srcdoc=\"&lt;!DOCTYPE html&gt;\n",
-       "&lt;html&gt;\n",
-       "&lt;head&gt;\n",
-       "    \n",
-       "    &lt;meta http-equiv=&quot;content-type&quot; content=&quot;text/html; charset=UTF-8&quot; /&gt;\n",
-       "    \n",
-       "        &lt;script&gt;\n",
-       "            L_NO_TOUCH = false;\n",
-       "            L_DISABLE_3D = false;\n",
-       "        &lt;/script&gt;\n",
-       "    \n",
-       "    &lt;style&gt;html, body {width: 100%;height: 100%;margin: 0;padding: 0;}&lt;/style&gt;\n",
-       "    &lt;style&gt;#map {position:absolute;top:0;bottom:0;right:0;left:0;}&lt;/style&gt;\n",
-       "    &lt;script src=&quot;https://cdn.jsdelivr.net/npm/[email protected]/dist/leaflet.js&quot;&gt;&lt;/script&gt;\n",
-       "    &lt;script src=&quot;https://code.jquery.com/jquery-3.7.1.min.js&quot;&gt;&lt;/script&gt;\n",
-       "    &lt;script src=&quot;https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js&quot;&gt;&lt;/script&gt;\n",
-       "    &lt;script src=&quot;https://cdnjs.cloudflare.com/ajax/libs/Leaflet.awesome-markers/2.0.2/leaflet.awesome-markers.js&quot;&gt;&lt;/script&gt;\n",
-       "    &lt;link rel=&quot;stylesheet&quot; href=&quot;https://cdn.jsdelivr.net/npm/[email protected]/dist/leaflet.css&quot;/&gt;\n",
-       "    &lt;link rel=&quot;stylesheet&quot; href=&quot;https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css&quot;/&gt;\n",
-       "    &lt;link rel=&quot;stylesheet&quot; href=&quot;https://netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css&quot;/&gt;\n",
-       "    &lt;link rel=&quot;stylesheet&quot; href=&quot;https://cdn.jsdelivr.net/npm/@fortawesome/[email protected]/css/all.min.css&quot;/&gt;\n",
-       "    &lt;link rel=&quot;stylesheet&quot; href=&quot;https://cdnjs.cloudflare.com/ajax/libs/Leaflet.awesome-markers/2.0.2/leaflet.awesome-markers.css&quot;/&gt;\n",
-       "    &lt;link rel=&quot;stylesheet&quot; href=&quot;https://cdn.jsdelivr.net/gh/python-visualization/folium/folium/templates/leaflet.awesome.rotate.min.css&quot;/&gt;\n",
-       "    \n",
-       "            &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width,\n",
-       "                initial-scale=1.0, maximum-scale=1.0, user-scalable=no&quot; /&gt;\n",
-       "            &lt;style&gt;\n",
-       "                #map_e32927666b28d271958699eb75c9b3de {\n",
-       "                    position: absolute;\n",
-       "                    width: 50.0%;\n",
-       "                    height: 100.0%;\n",
-       "                    left: 0.0%;\n",
-       "                    top: 0.0%;\n",
-       "                }\n",
-       "                .leaflet-container { font-size: 1rem; }\n",
-       "            &lt;/style&gt;\n",
-       "        \n",
-       "    \n",
-       "            &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width,\n",
-       "                initial-scale=1.0, maximum-scale=1.0, user-scalable=no&quot; /&gt;\n",
-       "            &lt;style&gt;\n",
-       "                #map_bbaf0c0bd1a55e590749e405c5e26755 {\n",
-       "                    position: absolute;\n",
-       "                    width: 50.0%;\n",
-       "                    height: 100.0%;\n",
-       "                    left: 50.0%;\n",
-       "                    top: 0.0%;\n",
-       "                }\n",
-       "                .leaflet-container { font-size: 1rem; }\n",
-       "            &lt;/style&gt;\n",
-       "        \n",
-       "    &lt;script src=&quot;https://cdn.jsdelivr.net/gh/jieter/Leaflet.Sync/L.Map.Sync.min.js&quot;&gt;&lt;/script&gt;\n",
-       "&lt;/head&gt;\n",
-       "&lt;body&gt;\n",
-       "    \n",
-       "    \n",
-       "            &lt;div class=&quot;folium-map&quot; id=&quot;map_e32927666b28d271958699eb75c9b3de&quot; &gt;&lt;/div&gt;\n",
-       "        \n",
-       "    \n",
-       "            &lt;div class=&quot;folium-map&quot; id=&quot;map_bbaf0c0bd1a55e590749e405c5e26755&quot; &gt;&lt;/div&gt;\n",
-       "        \n",
-       "&lt;/body&gt;\n",
-       "&lt;script&gt;\n",
-       "    \n",
-       "    \n",
-       "            var map_e32927666b28d271958699eb75c9b3de = L.map(\n",
-       "                &quot;map_e32927666b28d271958699eb75c9b3de&quot;,\n",
-       "                {\n",
-       "                    center: [33.6901, 118.9325],\n",
-       "                    crs: L.CRS.EPSG3857,\n",
-       "                    zoom: 5,\n",
-       "                    zoomControl: true,\n",
-       "                    preferCanvas: false,\n",
-       "                }\n",
-       "            );\n",
-       "\n",
-       "            \n",
-       "\n",
-       "        \n",
-       "    \n",
-       "            var tile_layer_43eced198f351a1c0d707a9014da2382 = L.tileLayer(\n",
-       "                &quot;https://tile.openstreetmap.org/{z}/{x}/{y}.png&quot;,\n",
-       "                {&quot;attribution&quot;: &quot;\\u0026copy; \\u003ca href=\\&quot;https://www.openstreetmap.org/copyright\\&quot;\\u003eOpenStreetMap\\u003c/a\\u003e contributors&quot;, &quot;detectRetina&quot;: false, &quot;maxNativeZoom&quot;: 19, &quot;maxZoom&quot;: 19, &quot;minZoom&quot;: 0, &quot;noWrap&quot;: false, &quot;opacity&quot;: 1, &quot;subdomains&quot;: &quot;abc&quot;, &quot;tms&quot;: false}\n",
-       "            );\n",
-       "        \n",
-       "    \n",
-       "            tile_layer_43eced198f351a1c0d707a9014da2382.addTo(map_e32927666b28d271958699eb75c9b3de);\n",
-       "        \n",
-       "    \n",
-       "            var tile_layer_88bc1f63e04a991c779b5da7850e12cb = L.tileLayer(\n",
-       "                &quot;https://openveda.cloud/api/raster/stac/tiles/WebMercatorQuad/{z}/{x}/{y}@1x?collection=no2-monthly\\u0026item=OMI_trno2_0.10x0.10_202002_Col3_V4.nc\\u0026assets=cog_default\\u0026color_formula=gamma+r+1.05\\u0026colormap_name=cool\\u0026rescale=-1018382487283302%2C50064805976866816&quot;,\n",
-       "                {&quot;attribution&quot;: &quot;VEDA&quot;, &quot;detectRetina&quot;: false, &quot;maxNativeZoom&quot;: 18, &quot;maxZoom&quot;: 18, &quot;minZoom&quot;: 0, &quot;noWrap&quot;: false, &quot;opacity&quot;: 0.8, &quot;subdomains&quot;: &quot;abc&quot;, &quot;tms&quot;: false}\n",
-       "            );\n",
-       "        \n",
-       "    \n",
-       "            tile_layer_88bc1f63e04a991c779b5da7850e12cb.addTo(map_e32927666b28d271958699eb75c9b3de);\n",
-       "        \n",
-       "    \n",
-       "            var map_bbaf0c0bd1a55e590749e405c5e26755 = L.map(\n",
-       "                &quot;map_bbaf0c0bd1a55e590749e405c5e26755&quot;,\n",
-       "                {\n",
-       "                    center: [33.6901, 118.9325],\n",
-       "                    crs: L.CRS.EPSG3857,\n",
-       "                    zoom: 5,\n",
-       "                    zoomControl: true,\n",
-       "                    preferCanvas: false,\n",
-       "                }\n",
-       "            );\n",
-       "\n",
-       "            \n",
-       "\n",
-       "        \n",
-       "    \n",
-       "            var tile_layer_60683b9265ccf303db1f8fcbff7b5bdb = L.tileLayer(\n",
-       "                &quot;https://tile.openstreetmap.org/{z}/{x}/{y}.png&quot;,\n",
-       "                {&quot;attribution&quot;: &quot;\\u0026copy; \\u003ca href=\\&quot;https://www.openstreetmap.org/copyright\\&quot;\\u003eOpenStreetMap\\u003c/a\\u003e contributors&quot;, &quot;detectRetina&quot;: false, &quot;maxNativeZoom&quot;: 19, &quot;maxZoom&quot;: 19, &quot;minZoom&quot;: 0, &quot;noWrap&quot;: false, &quot;opacity&quot;: 1, &quot;subdomains&quot;: &quot;abc&quot;, &quot;tms&quot;: false}\n",
-       "            );\n",
-       "        \n",
-       "    \n",
-       "            tile_layer_60683b9265ccf303db1f8fcbff7b5bdb.addTo(map_bbaf0c0bd1a55e590749e405c5e26755);\n",
-       "        \n",
-       "    \n",
-       "            var tile_layer_ca6be6d014cdfc7a72ce05073ade86d6 = L.tileLayer(\n",
-       "                &quot;https://openveda.cloud/api/raster/stac/tiles/WebMercatorQuad/{z}/{x}/{y}@1x?collection=no2-monthly\\u0026item=OMI_trno2_0.10x0.10_202202_Col3_V4.nc\\u0026assets=cog_default\\u0026color_formula=gamma+r+1.05\\u0026colormap_name=cool\\u0026rescale=-1018382487283302%2C50064805976866816&quot;,\n",
-       "                {&quot;attribution&quot;: &quot;VEDA&quot;, &quot;detectRetina&quot;: false, &quot;maxNativeZoom&quot;: 18, &quot;maxZoom&quot;: 18, &quot;minZoom&quot;: 0, &quot;noWrap&quot;: false, &quot;opacity&quot;: 0.8, &quot;subdomains&quot;: &quot;abc&quot;, &quot;tms&quot;: false}\n",
-       "            );\n",
-       "        \n",
-       "    \n",
-       "            tile_layer_ca6be6d014cdfc7a72ce05073ade86d6.addTo(map_bbaf0c0bd1a55e590749e405c5e26755);\n",
-       "        \n",
-       "    \n",
-       "            map_e32927666b28d271958699eb75c9b3de.sync(map_bbaf0c0bd1a55e590749e405c5e26755);\n",
-       "            map_bbaf0c0bd1a55e590749e405c5e26755.sync(map_e32927666b28d271958699eb75c9b3de);\n",
-       "        \n",
-       "&lt;/script&gt;\n",
-       "&lt;/html&gt;\" style=\"position:absolute;width:100%;height:100%;left:0;top:0;border:none !important;\" allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe></div></div>"
-      ],
-      "text/plain": [
-       "<folium.plugins.dual_map.DualMap at 0x7ff8ceff3bd0>"
-      ]
-     },
-     "execution_count": 9,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
+   "outputs": [],
    "source": [
     "# We'll import folium to map and folium.plugins to allow mapping side-by-side\n",
     "import folium\n",
@@ -526,7 +275,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.12.7"
   }
  },
  "nbformat": 4,