fix: update Tanager STAC notebook to improve footprint visualization and package imports (#266)

Author: giswqs

docs/examples/tanager_stac.ipynb

@@ -47,7 +47,8 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import hypercoast"
+    "import hypercoast\n",
+    "import geopandas as gpd"
    ]
   },
   {
@@ -67,7 +68,7 @@
    "source": [
     "## Display Tanager footprints\n",
     "\n",
-    "Use `tanager_footprints()` to collect STAC item footprints as a GeoDataFrame. By default, duplicate scenes that appear in multiple thematic collections are merged and their collection names are preserved in the `collections` and `collection_titles` columns.\n"
+    "The [planet-open-data](https://github.com/opengeos/planet-open-data) repository provides GeoJSON files containing the footprints of Tanager products, which are being updated daily. The following code reads the GeoJSON file and visualizes the footprints on a map."
    ]
   },
   {
@@ -77,8 +78,9 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "footprints = hypercoast.tanager_footprints()\n",
-    "len(footprints), footprints[[\"id\", \"collection_titles\", \"datetime\"]].head()"
+    "url = \"https://raw.githubusercontent.com/opengeos/planet-open-data/refs/heads/main/data/planet-tanager-sample-products/footprints.geojson\"\n",
+    "gdf = gpd.read_file(url)\n",
+    "print(f\"Number of footprints: {len(gdf)}\")"
    ]
   },
   {
@@ -87,24 +89,36 @@
    "id": "8",
    "metadata": {},
    "outputs": [],
+   "source": [
+    "gdf.head()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "9",
+   "metadata": {},
+   "outputs": [],
    "source": [
     "m = hypercoast.Map()\n",
-    "m.add_tanager_footprints(info_mode=\"on_click\")\n",
+    "m.add_gdf(gdf, layer_name=\"Tanager Footprints\")\n",
     "m"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "9",
+   "id": "10",
    "metadata": {},
    "source": [
-    "Draw a rectangle on the map. "
+    "## Search Tanager STAC items\n",
+    "\n",
+    "To search Tanager STAC items, draw a rectangle on the map. "
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "10",
+   "id": "11",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -114,10 +128,18 @@
     "    bbox = [-123.0, 37.0, -122.0, 38.1]"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "12",
+   "metadata": {},
+   "source": [
+    "Search for Tanager data from the [Tanager STAC catalog](https://www.planet.com/data/stac/browser/tanager-core-imagery/catalog.json): "
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "11",
+   "id": "13",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -132,7 +154,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "12",
+   "id": "14",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -142,7 +164,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "13",
+   "id": "15",
    "metadata": {},
    "source": [
     "## Visualize the ortho visual COG\n",
@@ -153,7 +175,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "14",
+   "id": "16",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -164,7 +186,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "15",
+   "id": "17",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -176,7 +198,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "16",
+   "id": "18",
    "metadata": {},
    "source": [
     "## Add a STAC item with spectral signatures\n",
@@ -187,7 +209,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "17",
+   "id": "19",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -200,7 +222,7 @@
   },
   {
    "cell_type": "markdown",
-   "id": "18",
+   "id": "20",
    "metadata": {},
    "source": [
     "## Download and read the spectral HDF5 asset\n",
@@ -211,7 +233,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "19",
+   "id": "21",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -226,7 +248,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "20",
+   "id": "22",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -242,7 +264,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "hyper",
+   "display_name": "geo",
    "language": "python",
    "name": "python3"
   },
@@ -256,7 +278,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.14"
+   "version": "3.12.12"
   }
  },
  "nbformat": 4,