rws-waterinfo 1.0.0

A Python wrapper for the Rijkswaterstaat WaterWebservices (ddapi20) API. Simplifies downloading observation data, forecasts, tidal extremes, chemical concentrations and more.

How to use

Provide user documentation here.

Installation

To install rws_waterinfo, do:

pip install rws-waterinfo

Run tests with:

pip install -r requirements-dev.txt
pytest

Example

Get observation data from Waterinfo using the ddapi20 API.

Location coordinates are no longer required; use the unified location codes (for example ameland.nes or hoekvanholland).

The primary change is the parameter format: the library now expects a list of lists (7 items) instead of the older 9-item format with X/Y coordinates.

New format (each inner list):

• compartiment_code

• eenheid_code

• meetapparaat_code

• grootheid_code

• locatie_code

• start_date (YYYY-MM-DD)

• end_date (YYYY-MM-DD)

By default the client uses parallel downloads for better performance. Use the max_workers argument to control concurrency.

import pandas as pd
import rws_waterinfo as rw

# Initialize rws_waterinfo library
params = [
    ["OW", "", "", "WATHTE", "ameland.nes", "2025-12-01", "2026-01-01"]
]

# Default is parallel download; specify max_workers if needed
df = rw.get_data(params=params, return_df=True, max_workers=8)
print(df.head())

This function sends a request to Waterinfo for parameter information and parses the response into a Pandas DataFrame. The DataFrame contains the locations and parameters combined into a single table.

import pandas as pd
import rws_waterinfo as rw

catalog = rw.get_catalog()
print(catalog.head())

License

Copyright (c) 2026, Rijkswaterstaat