Add support for visualizing Fields of The World (#957)

* Add support for visualizing Fields of The World

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Update notebook

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

docs/maplibre/fields_of_the_world.ipynb

@@ -0,0 +1,124 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "[![image](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://demo.leafmap.org/lab/index.html?path=maplibre/fields_of_the_world.ipynb)\n",
+    "[![image](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/opengeos/leafmap/blob/master/docs/maplibre/fields_of_the_world.ipynb)\n",
+    "[![image](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/opengeos/leafmap/HEAD)\n",
+    "\n",
+    "**Visualizing Agricultural Field Boundary Dataset - Field of the World**\n",
+    "\n",
+    "Fields of The World (FTW) is a comprehensive benchmark dataset designed to enhance the development of machine learning models for instance segmentation of agricultural field boundaries. It aggregates and harmonizes a number of open datasets into 1.6 million parcel boundaries and over 70,000 samples covering diverse agricultural landscapes across 4 continents and 24 countries.\n",
+    "\n",
+    "For more information about Field of the World, please visit: https://fieldsofthe.world\n",
+    "\n",
+    "Uncomment the following line to install [leafmap](https://leafmap.org) if needed."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# %pip install \"leafmap[maplibre]\""
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import leafmap.maplibregl as leafmap"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "url = \"https://data.source.coop/kerner-lab/fields-of-the-world/ftw-sources.pmtiles\"\n",
+    "metadata = leafmap.pmtiles_metadata(url)\n",
+    "print(f\"layer names: {metadata['layer_names']}\")\n",
+    "print(f\"bounds: {metadata['bounds']}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m = leafmap.Map()\n",
+    "url = \"https://data.source.coop/kerner-lab/fields-of-the-world/ftw-sources.pmtiles\"\n",
+    "style = {\n",
+    "    \"layers\": [\n",
+    "        {\n",
+    "            \"id\": \"Field Polygon\",\n",
+    "            \"source\": \"example_source\",\n",
+    "            \"source-layer\": \"ftw-sources\",\n",
+    "            \"type\": \"fill\",\n",
+    "            \"paint\": {\n",
+    "                \"fill-color\": \"#ffff00\",\n",
+    "                \"fill-opacity\": 0.2,\n",
+    "            },\n",
+    "        },\n",
+    "        {\n",
+    "            \"id\": \"Field Outline\",\n",
+    "            \"source\": \"example_source\",\n",
+    "            \"source-layer\": \"ftw-sources\",\n",
+    "            \"type\": \"line\",\n",
+    "            \"paint\": {\"line-color\": \"#ff0000\", \"line-width\": 1, \"line-opacity\": 1},\n",
+    "        },\n",
+    "    ],\n",
+    "}\n",
+    "\n",
+    "m.add_basemap(\"Satellite\")\n",
+    "m.add_pmtiles(url, style=style, name=\"FTW\", zoom_to_layer=False)\n",
+    "m.add_layer_control()\n",
+    "m"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "m.layer_interact()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "![image](https://github.com/user-attachments/assets/933264d9-378b-4943-9611-0e105b250f63)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

docs/maplibre/overview.md

@@ -236,6 +236,12 @@ Use the draw control to draw features on the map.
 
 [![](https://i.imgur.com/w8UFssd.png)](https://leafmap.org/maplibre/draw_features)
 
+## Visualize fields of the world
+
+Visualize Agricultural Field Boundary Dataset - Field of the World.
+
+[![](https://i.imgur.com/0A9yuyL.png)](https://leafmap.org/maplibre/fields_of_the_world)
+
 ## Use a fallback image
 
 Use a coalesce expression to display another image when a requested image is not available.

leafmap/maplibregl.py

@@ -1855,7 +1855,13 @@ def add_pmtiles(
                 layer = Layer(**params)
                 self.add_layer(layer)
                 self.set_visibility(params["id"], visible)
-                self.set_opacity(params["id"], opacity)
+                if "paint" in params:
+                    for key in params["paint"]:
+                        if "opacity" in key:
+                            self.set_opacity(params["id"], params["paint"][key])
+                            break
+                    else:
+                        self.set_opacity(params["id"], opacity)
 
                 if tooltip:
                     self.add_tooltip(params["id"], properties, template)

mkdocs.yml

@@ -182,6 +182,7 @@ nav:
           - maplibre/drag_a_marker.ipynb
           - maplibre/draw_features.ipynb
           - maplibre/fallback_image.ipynb
+          - maplibre/fields_of_the_world.ipynb
           - maplibre/fit_bounds.ipynb
           - maplibre/fill_pattern.ipynb
           - maplibre/fly_to.ipynb