saeonobspy is a Python package for interacting with the South African Environmental Observation Network (SAEON) observations database API. It provides a simple interface to view available datasets and download observation data.
Install saeonobspy using pip:
pip install saeonobspyTo use saeonobsr you need to first register an account SAEON observations database. Once registered you need to login and retrieve an API token from https://observations.saeon.ac.za/account/token. This token will be valid for 1 month.
Before starting set your API access token using
import os
os.environ["OBSDB_KEY"] = "xxx"Below is an example of using the package to view available datasets and download a set of observations:
import geopandas as gpd
from saeonobspy import SAEONObsAPI
# Initialize the API
saeon_api = SAEONObsAPI()
# View available datasets
datasets_df = saeon_api.view_datasets()
# Filter datasets by a specific area (optional)
extent_gdf = gpd.read_file('path/to/extent/shapefile.shp')
spatial_datasets_gdf = saeon_api.view_datasets(extent=extent_gdf, spatial=True)
# Filter the datasets DataFrame based on your criteria
filtered_datasets_df = datasets_df[datasets_df['siteName'] == 'Constantiaberg']
filtered_datasets_df = filtered_datasets_df[filtered_datasets_df['description'] == 'Air Temperature - Daily Minimum - Degrees Celsius']
# Download observation data
obs_data = saeon_api.get_datasets(filtered_datasets_df, start_date='2020-01-01', end_date='2020-12-31')
print(obs_data)For more information on how to use the package, please refer to the documentation in the source code.
This package is licensed under the MIT License. See the LICENSE file for more information.