refactor(examples): add urban H3 urban layer starting point

Author: simonprovost

docs/copy_of_examples/1-Per-Module/2-urban_layer.ipynb

@@ -20,9 +20,18 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "/Users/sgp28/Desktop/Delivery/NYU/UrbanMapper/.venv/lib/python3.10/site-packages/DataProfileViewer/_plot_metadata_table.py:1: UserWarning: pkg_resources is deprecated as an API. See https://setuptools.pypa.io/en/latest/pkg_resources.html. The pkg_resources package is slated for removal as early as 2025-11-30. Refrain from using this package or pin to Setuptools<81.\n",
+      "  import pkg_resources\n"
+     ]
+    }
+   ],
    "source": [
     "import urban_mapper as um\n",
     "\n",
@@ -76,6 +85,35 @@
     "layer.static_render()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Creating an Uber H3 Grid\n",
+    "\n",
+    "Generate a hexagonal grid over a place of interest using the `uber_h3` urban layer type."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "metadata": {},
+   "source": [
+    "uber_h3_layer = (\n",
+    "    mapper.urban_layer.with_type(\"uber_h3\")\n",
+    "    .from_place(\"Manhattan, New York City, USA\", resolution=9)\n",
+    "    .with_mapping(\n",
+    "        longitude_column=\"longitude\",\n",
+    "        latitude_column=\"latitude\",\n",
+    "        output_column=\"nearest_h3_cell\",\n",
+    "    )\n",
+    "    .build()\n",
+    ")\n",
+    "uber_h3_layer.preview()\n",
+    "uber_h3_layer.static_render()"
+   ],
+   "outputs": [],
+   "execution_count": null
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

examples/1-Per-Module/2-urban_layer.ipynb

@@ -20,9 +20,18 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "/Users/sgp28/Desktop/Delivery/NYU/UrbanMapper/.venv/lib/python3.10/site-packages/DataProfileViewer/_plot_metadata_table.py:1: UserWarning: pkg_resources is deprecated as an API. See https://setuptools.pypa.io/en/latest/pkg_resources.html. The pkg_resources package is slated for removal as early as 2025-11-30. Refrain from using this package or pin to Setuptools<81.\n",
+      "  import pkg_resources\n"
+     ]
+    }
+   ],
    "source": [
     "import urban_mapper as um\n",
     "\n",
@@ -76,6 +85,35 @@
     "layer.static_render()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Creating an Uber H3 Grid\n",
+    "\n",
+    "Generate a hexagonal grid over a place of interest using the `uber_h3` urban layer type."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "metadata": {},
+   "source": [
+    "uber_h3_layer = (\n",
+    "    mapper.urban_layer.with_type(\"uber_h3\")\n",
+    "    .from_place(\"Manhattan, New York City, USA\", resolution=9)\n",
+    "    .with_mapping(\n",
+    "        longitude_column=\"longitude\",\n",
+    "        latitude_column=\"latitude\",\n",
+    "        output_column=\"nearest_h3_cell\",\n",
+    "    )\n",
+    "    .build()\n",
+    ")\n",
+    "uber_h3_layer.preview()\n",
+    "uber_h3_layer.static_render()"
+   ],
+   "outputs": [],
+   "execution_count": null
+  },
   {
    "cell_type": "markdown",
    "metadata": {},