{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Web Feature Service - Accessing region countours saved on a GeoServer\n", "\n", "In this example, we're going to look at some layers that are currently accessible on our instance of GeoServer. With WFS, we can see what is available, collect the layers we want by using a query, download the results in geoJSON, and visualize them using `geopandas`." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We begin by loading the libraries needed for parsing and downloading from WFS and for opening and visualizing the results" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "%matplotlib inline\n", "\n", "import os\n", "from tempfile import NamedTemporaryFile\n", "\n", "os.environ[\"USE_PYGEOS\"] = \"0\" # force use Shapely with GeoPandas\n", "\n", "import geopandas as gpd\n", "\n", "# Import WFS from owslib\n", "from owslib.wfs import WebFeatureService" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We start by making a connection to the PAVICS instance we have locally on our server. Using WFS, we can very quickly see the contents, which are the layers and the workspaces they're located with (ie: TravisTest, scratchTJS). These layer names act as dictionaries for " ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "['TravisTest:NE_Admin_Level0',\n", " 'TravisTest:mrc_poly',\n", " 'TravisTest:region_admin_poly',\n", " 'public:CANOPEX_5797_basinBoundaries',\n", " 'public:CANVEC_hydro_waterbodies',\n", " 'public:CanVec_Rivers',\n", " 'public:CanVec_WaterBodies',\n", " 'public:HydroLAKES_points',\n", " 'public:HydroLAKES_poly',\n", " 'public:USGS_HydroBASINS_lake_ar_lev12',\n", " 'public:USGS_HydroBASINS_lake_na_lev12',\n", " 'public:canada_admin_boundaries',\n", " 'public:decamillenial_flood_CC',\n", " 'public:gaspesie_mrc',\n", " 'public:global_admin_boundaries',\n", " 'public:ne_10m_populated_places',\n", " 'public:quebec_admin_boundaries',\n", " 'public:quebec_health_regions',\n", " 'public:quebec_mrc_boundaries',\n", " 'public:quebec_muni_boundaries',\n", " 'public:routing_1kmLakes_07',\n", " 'public:routing_1kmLakes_08',\n", " 'public:routing_1kmLakes_09',\n", " 'public:routing_1kmLakes_10',\n", " 'public:routing_1kmLakes_11',\n", " 'public:routing_1kmLakes_12',\n", " 'public:routing_allLakes_07',\n", " 'public:routing_allLakes_08',\n", " 'public:routing_allLakes_09',\n", " 'public:routing_allLakes_10',\n", " 'public:routing_allLakes_11',\n", " 'public:routing_allLakes_12',\n", " 'public:test_regions',\n", " 'public:test_regions_lambert',\n", " 'public:usa_admin_boundaries',\n", " 'public:wshed_bound_n1',\n", " 'public:wshed_bound_n2',\n", " 'public:wshed_bound_n3']" ] }, "execution_count": 2, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# NBVAL_IGNORE_OUTPUT\n", "\n", "wfs_url = \"https://pavics.ouranos.ca/geoserver/wfs\" # TEST_USE_PROD_DATA\n", "\n", "# Connect to GeoServer WFS service.\n", "wfs = WebFeatureService(wfs_url, version=\"2.0.0\")\n", "\n", "# Print the list of available layers\n", "sorted(wfs.contents.keys())" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "More information about each layer is stored in the `contents` dictionary. " ] }, { "cell_type": "code", "execution_count": 3, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Layer ID: public:USGS_HydroBASINS_lake_na_lev12\n", "Title: USGS_HydroBASINS_lake_na_lev12\n", "Boundaries: (-180.0, -90.0, 180.0, 90.0) \n", "\n", "Layer ID: public:canada_admin_boundaries\n", "Title: Canada Administrative Boundaries\n", "Boundaries: (-141.01807315799994, 41.681435425000075, -52.61940850399992, 83.13550252400006) \n", "\n", "Layer ID: public:decamillenial_flood_CC\n", "Title: decamillenial_flood_CC\n", "Boundaries: (-180.0, -90.0, 180.0, 90.0) \n", "\n" ] } ], "source": [ "# NBVAL_IGNORE_OUTPUT\n", "\n", "sorted_layer_ids = sorted(wfs.contents.keys())\n", "canada_admin_boundaries_index = sorted_layer_ids.index(\"public:canada_admin_boundaries\")\n", "\n", "for layerID in sorted_layer_ids[\n", " canada_admin_boundaries_index - 1 : canada_admin_boundaries_index + 2\n", "]:\n", " layer = wfs[layerID]\n", " print(\"Layer ID:\", layerID)\n", " print(\"Title:\", layer.title)\n", " print(\"Boundaries:\", layer.boundingBoxWGS84, \"\\n\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can then perform a `GetFeatures` call using the layer name as a target. This returns an IOstream that can be written as a geoJSON file, a common file format for vector data served throughout the web. To reduce the download size, we'll only fetch the features (here polygons), intersecting a small region defined by a bounding box. " ] }, { "cell_type": "code", "execution_count": 4, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Canada Administrative Boundaries\n" ] }, { "data": { "text/plain": [ "'/tmp/tmpvipe3any.geojson'" ] }, "execution_count": 4, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# NBVAL_IGNORE_OUTPUT\n", "\n", "layer_id = \"public:canada_admin_boundaries\"\n", "meta = wfs.contents[layer_id]\n", "print(meta.title)\n", "\n", "# Get the actual data\n", "data = wfs.getfeature(\n", " typename=\"public:canada_admin_boundaries\",\n", " bbox=(-74.5, 45.2, -73, 46),\n", " outputFormat=\"JSON\",\n", ")\n", "\n", "# Write to file\n", "outfile = NamedTemporaryFile(delete=False, suffix=\".geojson\")\n", "with open(outfile.name, \"wb\") as fh:\n", " fh.write(data.read())\n", "outfile.name" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Once the geoJSON file is downloaded, we can either open it with a GIS application or we can read the features using geopandas." ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "tags": [] }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "layers = gpd.read_file(outfile.name)\n", "layers.plot()\n", "\n", "# Clean up\n", "outfile.close()" ] } ], "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.12.13" } }, "nbformat": 4, "nbformat_minor": 4 }