added folium use case

Author: grallewellyn

docs/python-usage.ipynb

@@ -65,6 +65,7 @@
     "import cartopy.crs as ccrs\n",
     "import cartopy\n",
     "from cartopy.mpl.gridliner import LONGITUDE_FORMATTER, LATITUDE_FORMATTER\n",
+    "import folium\n",
     "import urllib.request\n",
     "import urllib.parse\n",
     "import mapbox_vector_tile\n",
@@ -868,6 +869,49 @@
     "print('')"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "b7a0e761",
+   "metadata": {},
+   "source": [
+    "<a id=\"visualize_wms_global_raster_data\"></a>\n",
+    "\n",
+    "### Visualize WMS Global Raster Data with Folium \n",
+    "\n",
+    "<DIV align=\"left\" style=\"line-height:1.5em;\">\n",
+    "<p>\n",
+    "    \n",
+    "This example shows how to display a WMS global image on an OpenStreetMap using Folium.\n",
+    "    \n",
+    "</p>\n",
+    "</DIV>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "14fcbee2",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Other tile options are \"CartoDB Positron\" and \"CartoDB Voyager\"\n",
+    "m = folium.Map(location=[41, -70], zoom_start=4, tiles=\"OpenStreetMap\")\n",
+    "\n",
+    "folium.WmsTileLayer(\n",
+    "    url=\"https://gibs.earthdata.nasa.gov/wms/epsg4326/best/wms.cgi\",\n",
+    "    name=\"WMS Landsat Reflectance\",\n",
+    "    fmt=\"image/png\",\n",
+    "    layers=\"Landsat_WELD_CorrectedReflectance_Bands157_Global_Annual\",\n",
+    "    transparent=True,\n",
+    "    overlay=True,\n",
+    "    control=True,\n",
+    ").add_to(m)\n",
+    "\n",
+    "folium.LayerControl().add_to(m)\n",
+    "\n",
+    "m"
+   ]
+  },
   {
    "attachments": {},
    "cell_type": "markdown",