Geoconnex reference collections
Provide your CKAN instance with hydrologic features using Geoconnex reference collections.
Geoconnex reference collections are collections of hydrologic-related geospatial features. These include HUC08 Subbasins, USGS National Aquifers, Census Designated Places, and more available to sync with your CKAN instance's region using ckanext-gztr.
Get started with Geoconnex reference collections for your CKAN instance
In this tutorial we'll attempt to:
- Download a subset of geospatial features from a Geoconnex reference collection based on a bounding box you define or a preset query filter using the Geoconnex Reference API as a GeoParquet file.
- Upload your GeoParquet file to the
gztrstorage. - Update your
config.jsonfile to point to your geospatial collection. - View your geospatial collection on your CKAN instance.
- (Optional) Enable the Geoconnex integration to sync your water data with Geoconnex
After following these steps, you could run these steps as a cron job to automatically update your geospatial collections on a periodic basis (there is an example at the end).
1. Download geospatial features for your region
Choose a reference collection
First you'll want to identify a Geoconnex reference collection that you want to add to your CKAN instance.
Browse through the reference collections here.
For example we'll add a subset of HUC08 subbasins and counties to our CKAN instance based on our region.
Define a filter for your region
Our CKAN instance is (likely) not globally-scoped, but rather it exists for storing a particular region's water data. Therefore we want to filter for the CKAN instance's region of interest and download a subset of the Geoconnex reference collection instead of the entire reference collection.
To filter the reference collection, the Geoconnex Reference API demonstrates several methods for filtering the reference collection as it is OpenAPI-compatible with a SwaggerUI interface.
Let's start with the HUC08 sub-basins. You can draw and export a bounding box from geojson.io and use that value in your API request using the bbox parameter.