{ "cells": [ { "cell_type": "markdown", "id": "0d4e3676", "metadata": { "papermill": { "duration": 0.003446, "end_time": "2026-11-10T11:28:33.452645+00:00", "exception": false, "start_time": "2026-11-10T11:28:33.449199+00:00", "status": "completed" }, "tags": [] }, "source": [ "# Daily weather observations from KNMI: Open Data API vs EDR API\n", "\n", "This notebook shows how to get data from the\n", "[KNMI Data Platform](https://dataplatform.knmi.nl/) with the `knmidata`\n", "Python package, using the dataset\n", "[**daily-in-situ-meteorological-observations**](https://dataplatform.knmi.nl/dataset/access/daily-in-situ-meteorological-observations-1-0)\n", "(daily observations from the Dutch automatic weather stations).\n", "\n", "We fetch the same dataset through **both** APIs and compare:\n", "\n", "1. **Open Data API** — download whole files (NetCDF) and open them as one\n", " `xarray.Dataset`.\n", "2. **EDR API** — run spatio-temporal *queries* (location / area), parse the\n", " response into an `xarray.Dataset`, and plot the time series of\n", " precipitation (RH), temperature (TG) and evaporation (EV24) at De Bilt.\n" ] }, { "cell_type": "markdown", "id": "6aaa0705", "metadata": { "papermill": { "duration": 0.001881, "end_time": "2026-11-10T11:28:33.457157+00:00", "exception": false, "start_time": "2026-11-10T11:28:33.455276+00:00", "status": "completed" }, "tags": [] }, "source": [ "## How KNMI data is organized\n", "\n", "- The **KNMI Data Platform** (`dataplatform.knmi.nl`) is the data catalog.\n", " Everything in it is a **dataset** with a unique *name* and *version*\n", " (e.g. `daily-in-situ-meteorological-observations`, version `1.0`). The\n", " version matters: the API paths contain both.\n", "- Datasets come in two flavours:\n", " - **in-situ observations**: point measurements at automatic weather\n", " stations (AWS), e.g. temperature, wind, precipitation per station;\n", " - **gridded products**: radar composites, HARMONIE model output, satellite\n", " imagery — regularly spaced grids.\n", "- Each dataset is exposed through one or two APIs (see the \"Access\" tab on\n", " the dataset page):\n", " - the **Open Data API** (`/open-data/v1`): file-based — you list files and\n", " download them (via temporary presigned S3 URLs);\n", " - the **EDR API** (`/edr/v1`): an OGC standard for spatio-temporal\n", " *queries* — you ask for a point, area, or cube and get back a structured\n", " payload (CoverageJSON), no files involved.\n", "- Times are **UTC** everywhere. KNMI file names embed the observation time\n", " (e.g. `..._20260601.nc` = 2026-06-01).\n", "- This dataset holds **daily** values per station. The variable codes are the\n", " classic KNMI \"etmaalwaarden\" codes: **TG** = daily mean temperature (°C),\n", " **RH** = daily precipitation sum (mm), **EV24** = Makkink reference\n", " evaporation (mm), plus TN/TX (min/max temperature), FG (mean wind), etc." ] }, { "cell_type": "markdown", "id": "ddcca7a3", "metadata": { "papermill": { "duration": 0.001762, "end_time": "2026-11-10T11:28:33.460727+00:00", "exception": false, "start_time": "2026-11-10T11:28:33.458965+00:00", "status": "completed" }, "tags": [] }, "source": [ "## The two APIs at a glance\n", "\n", "| | Open Data API | EDR API |\n", "|---|---|---|\n", "| Base URL | `api.dataplatform.knmi.nl/open-data/v1` | `api.dataplatform.knmi.nl/edr/v1` |\n", "| Model | list *files* in a dataset, get a presigned download URL per file | query a *collection* by location/time/parameters |\n", "| Typical use | bulk download of whole files / long history | targeted extracts: one station, one period, a few parameters |\n", "| You get | NetCDF/HDF5 files on disk → `xarray` | CoverageJSON/GeoJSON → parsed to `xarray.Dataset` in memory |\n", "| Granularity | whole files (all stations/variables in the file) | exactly the queried subset |\n", "| Auth | anonymous key possible (shared, rate-limited) | registered key required (dedicated quota) |\n", "\n", "Rule of thumb: **use EDR when you know what you want** (a station, a bbox, a\n", "time range, a few variables); **use Open Data when you want everything**\n", "(whole files, full archives, model/radar grids)." ] }, { "cell_type": "markdown", "id": "e956da2a", "metadata": { "papermill": { "duration": 0.00162, "end_time": "2026-11-10T11:28:33.464108+00:00", "exception": false, "start_time": "2026-11-10T11:28:33.462488+00:00", "status": "completed" }, "tags": [] }, "source": [ "## Authentication\n", "\n", "Every request needs an API key in the `Authorization` header (raw key, no\n", "`Bearer` prefix). Request a free registered key at\n", "[developer.dataplatform.knmi.nl](https://developer.dataplatform.knmi.nl/).\n", "\n", "`knmidata` resolves keys in this order — explicit argument first, then\n", "environment variables:\n", "\n", "| API | Argument | Environment variables |\n", "|---|---|---|\n", "| Open Data | `api_key=` | `KNMI_OPENDATA_API_KEY` (+`_FILE`), then the public anonymous key |\n", "| EDR | `edr_key=` | `KNMI_EDR_API_KEY` (+`_FILE`) |\n", "\n", "Note: **Open Data and EDR keys are not interchangeable**, and the EDR API\n", "has no anonymous key. The anonymous Open Data key is published on the docs\n", "page and scraped automatically by `knmidata`, but it shares one rate limit\n", "across all anonymous users.\n", "\n", "### Keeping the key out of shared notebooks\n", "\n", "**Never paste the key into a notebook cell** — anyone who can view the\n", "notebook (or its saved outputs, git history, screenshots) can see it. Safe\n", "patterns, in order of preference:\n", "\n", "1. **`.env` file (gitignored) + python-dotenv.** Create a `.env` file (see the README Authentication section)\n", " to `.env`, fill in your keys, `chmod 600 .env`. `.env` is in\n", " `.gitignore`, so it is never committed. In the notebook, only load it:\n", " `load_dotenv()` — the key itself never appears in the notebook.\n", " Install with `pip install knmidata[dotenv]`.\n", "2. **Shell environment variables**: `export KNMI_OPENDATA_API_KEY=...` /\n", " `export KNMI_EDR_API_KEY=...` in your profile or before launching Jupyter.\n", "3. **Key file**: set `KNMI_OPENDATA_API_KEY_FILE=/path/to/key.txt` (chmod 600)\n", " instead of the key itself; `knmidata` reads the file for you.\n", "4. **GitHub Actions**: store the key as a repository *secret* and pass it\n", " to the workflow step as an env var (see `.github/workflows/documentation.yml`,\n", " which executes this notebook in CI) — GitHub masks secret values in logs.\n", "\n", "Additional hygiene: `knmidata` never prints or logs the key (check with\n", "`bool(os.environ.get(\"KNMI_OPENDATA_API_KEY\"))`, not by printing it); when sharing an\n", "executed `.ipynb`, strip outputs first (the repo's pre-commit already runs\n", "`nbstripout`); if a key ever does leak, revoke/rotate it in the\n", "[developer portal](https://developer.dataplatform.knmi.nl/)." ] }, { "cell_type": "code", "execution_count": 1, "id": "d7dd660b", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:33.468879Z", "iopub.status.busy": "2026-11-10T11:28:33.468639Z", "iopub.status.idle": "2026-11-10T11:28:36.490742Z", "shell.execute_reply": "2026-11-10T11:28:36.489843Z" }, "lines_to_next_cell": 0, "papermill": { "duration": 3.025947, "end_time": "2026-11-10T11:28:36.491749+00:00", "exception": false, "start_time": "2026-11-10T11:28:33.465802+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Versions:\n", " python: 3.13.18\n", " knmidata: 2.0.0\n", " httpx: 0.28.1\n", " xarray: 2026.9.0\n", " h5netcdf: 1.8.2\n" ] } ], "source": [ "from pathlib import Path\n", "\n", "import matplotlib.pyplot as plt\n", "import pandas as pd\n", "\n", "import knmidata\n", "\n", "# The dataset from the KNMI Data Platform page linked above.\n", "DATASET_NAME = \"daily-in-situ-meteorological-observations\"\n", "DATASET_VERSION = \"1.0\"\n", "COLLECTION = \"daily-in-situ-meteorological-observations\" # EDR collection id\n", "\n", "# The variables we plot below (classic KNMI daily \"etmaalwaarden\" codes):\n", "# RH = daily precipitation sum (mm), TG = daily mean temperature (degC),\n", "# EV24 = Makkink reference evaporation (mm).\n", "PARAMETERS = [\"RH\", \"TG\", \"EV24\"]\n", "\n", "# De Bilt (KNMI's own station, WSI 0-20000-0-06260), as (lon, lat) — the\n", "# station's grid point in the EDR responses.\n", "STATION_COORDS = (5.18, 52.10)\n", "# Bounding box over the Netherlands: (minx, miny, maxx, maxy).\n", "NL_BBOX = (3.0, 50.5, 7.5, 53.7)\n", "\n", "# Time arguments accept str, pd.Timestamp, datetime, or date; naive = UTC.\n", "# One week of daily values (change to e.g. a month for a longer time series).\n", "START = pd.Timestamp(\"2026-06-01\")\n", "END = pd.Timestamp(\"2026-06-08\")\n", "\n", "# Downloaded Open Data files are kept here (omit cache_dir to load into\n", "# memory only and delete the files afterwards).\n", "CACHE_DIR = Path(\"data\")\n", "\n", "knmidata.show_versions()" ] }, { "cell_type": "markdown", "id": "0cec2759", "metadata": { "papermill": { "duration": 0.002134, "end_time": "2026-11-10T11:28:36.496506+00:00", "exception": false, "start_time": "2026-11-10T11:28:36.494372+00:00", "status": "completed" }, "tags": [] }, "source": [ "## Setup: create a client\n", "\n", "`KNMIClient` is the synchronous client (runs everything on a background\n", "event loop, so it also works inside Jupyter). For async code use\n", "`AsyncKNMIClient` instead. Without keys, Open Data falls back to the\n", "anonymous key; the EDR part below checks whether a key is available and\n", "skips gracefully otherwise." ] }, { "cell_type": "code", "execution_count": 2, "id": "113f870a", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:36.501247Z", "iopub.status.busy": "2026-11-10T11:28:36.500949Z", "iopub.status.idle": "2026-11-10T11:28:36.676848Z", "shell.execute_reply": "2026-11-10T11:28:36.675904Z" }, "papermill": { "duration": 0.179224, "end_time": "2026-11-10T11:28:36.677714+00:00", "exception": false, "start_time": "2026-11-10T11:28:36.498490+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "KNMI_OPENDATA_API_KEY set: True\n", "KNMI_EDR_API_KEY set: True\n" ] } ], "source": [ "import os\n", "\n", "# Load keys from the gitignored .env file (see the README Authentication section).\n", "# The key itself never appears in this notebook. On GitHub Actions, skip the\n", "# .env file: store the key as a repository *secret* and expose it to the\n", "# workflow as an env var (see .github/workflows/documentation.yml) — GitHub\n", "# masks secret values in logs.\n", "try:\n", " from dotenv import load_dotenv\n", "\n", " load_dotenv(\".env\")\n", "except ImportError:\n", " pass # alternative: export KNMI_OPENDATA_API_KEY / KNMI_EDR_API_KEY in your shell\n", "\n", "# Presence check only — never print the key itself.\n", "print(\"KNMI_OPENDATA_API_KEY set:\", bool(os.environ.get(\"KNMI_OPENDATA_API_KEY\")))\n", "print(\"KNMI_EDR_API_KEY set:\", bool(os.environ.get(\"KNMI_EDR_API_KEY\")))\n", "\n", "try:\n", " client = knmidata.KNMIClient(\n", " api_key=os.environ.get(\"KNMI_OPENDATA_API_KEY\") or None,\n", " edr_key=os.environ.get(\"KNMI_EDR_API_KEY\") or None,\n", " ) # keys are resolved from the environment\n", " client_ok = True\n", "except knmidata.KNMIAuthError as exc:\n", " client = None\n", " client_ok = False\n", " print(f\"Could not create a client (no usable key?): {exc}\")" ] }, { "cell_type": "markdown", "id": "5ab381c3", "metadata": { "papermill": { "duration": 0.002045, "end_time": "2026-11-10T11:28:36.682578+00:00", "exception": false, "start_time": "2026-11-10T11:28:36.680533+00:00", "status": "completed" }, "tags": [] }, "source": [ "## 1. Open Data API — list and download whole files\n", "\n", "The Open Data API is **file-based**:\n", "\n", "1. `GET /datasets/{name}/versions/{version}/files` lists the files, with\n", " cursor pagination (`maxKeys` up to 1000 + `nextPageToken`).\n", "2. Time filtering uses `begin`/`end`, but note: they are compared against\n", " the `orderBy` attribute. `knmidata` therefore sends\n", " `orderBy=lastModified` automatically when you pass `start_time`/`end_time`\n", " (with the default `orderBy=filename`, `begin`/`end` would be compared as\n", " *filename strings* instead of timestamps).\n", "3. `GET .../files/{filename}/url` returns a short-lived **presigned S3 URL**.\n", "4. The file is streamed to disk (atomic `.part` → rename, size-checked), and\n", " `get_dataset` assembles the files into one `xarray.Dataset`\n", " (`combine_by_coords` over the time dimension)." ] }, { "cell_type": "code", "execution_count": 3, "id": "1a5a5764", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:36.687330Z", "iopub.status.busy": "2026-11-10T11:28:36.687116Z", "iopub.status.idle": "2026-11-10T11:28:37.236297Z", "shell.execute_reply": "2026-11-10T11:28:37.235352Z" }, "lines_to_next_cell": 2, "papermill": { "duration": 0.552434, "end_time": "2026-11-10T11:28:37.236941+00:00", "exception": false, "start_time": "2026-11-10T11:28:36.684507+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "7 files between 2026-06-01 00:00:00 and 2026-06-08 00:00:00: ['daily-observations-20260531.nc', 'daily-observations-20260601.nc', 'daily-observations-20260602.nc', 'daily-observations-20260603.nc', 'daily-observations-20260604.nc', 'daily-observations-20260605.nc', 'daily-observations-20260606.nc']\n" ] } ], "source": [ "files = client.opendata.list_files(\n", " DATASET_NAME,\n", " DATASET_VERSION,\n", " start_time=START,\n", " end_time=END,\n", ")\n", "print(f\"{len(files)} files between {START} and {END}: {files}\")" ] }, { "cell_type": "markdown", "id": "1e965dfc", "metadata": { "papermill": { "duration": 0.002308, "end_time": "2026-11-10T11:28:37.242452+00:00", "exception": false, "start_time": "2026-11-10T11:28:37.240144+00:00", "status": "completed" }, "tags": [] }, "source": [ "Now download just the first two files of that period and open them as a\n", "single dataset. Each **daily** file contains all stations for that day, so\n", "even `max_files=2` already gives you a 2-day, all-stations slice.\n", "\n", "`start_time`/`end_time` are normalized to UTC ISO-8601 (`...Z`) before being\n", "sent — passing `pd.Timestamp` objects is fine." ] }, { "cell_type": "code", "execution_count": 4, "id": "d3eb150d", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:37.247334Z", "iopub.status.busy": "2026-11-10T11:28:37.247130Z", "iopub.status.idle": "2026-11-10T11:28:40.304843Z", "shell.execute_reply": "2026-11-10T11:28:40.303922Z" }, "papermill": { "duration": 3.061127, "end_time": "2026-11-10T11:28:40.305565+00:00", "exception": false, "start_time": "2026-11-10T11:28:37.244438+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "/home/runner/work/KNMI_Data_Platform/KNMI_Data_Platform/.tox/notebooks/lib/python3.13/site-packages/knmidata/opendata/parsers.py:52: FutureWarning: In a future version of xarray the default value for data_vars will change from data_vars='all' to data_vars=None. This is likely to lead to different results when multiple datasets have matching variables with overlapping values. To opt in to new defaults and get rid of these warnings now use `set_options(use_new_combine_kwarg_defaults=True) or set data_vars explicitly.\n", " return cast(\"xr.Dataset\", xr.combine_by_coords(datasets))\n" ] }, { "name": "stdout", "output_type": "stream", "text": [ "\n", "Downloaded files are cached in: /home/runner/work/KNMI_Data_Platform/KNMI_Data_Platform/data\n", "\n", "Combined dataset:\n", " Size: 267kB\n", "Dimensions: (time: 7, station: 67)\n", "Coordinates:\n", " * time (time) datetime64[ns] 56B 2026-06-01 2026-06-02 ... 2026-06-07\n", " * station (station) Size: 328B\n", "Dimensions: (station: 1, time: 8)\n", "Coordinates:\n", " * station (station) " ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "fig, axes = plt.subplots(\n", " len(PARAMETERS),\n", " 1,\n", " figsize=(9, 2.5 * len(PARAMETERS)),\n", " sharex=True,\n", " layout=\"tight\",\n", ")\n", "for ax, var in zip(axes, PARAMETERS, strict=True):\n", " # drop singleton dims (x, y, station, coverage) so a 1D time series remains\n", " da = ts[var].squeeze(drop=True)\n", " for d in list(da.dims):\n", " if d != \"time\" and da.sizes[d] > 1:\n", " da = da.isel({d: 0})\n", " da.plot(ax=ax, marker=\"o\", label=\"EDR\")\n", " das = ds.sel(station=de_bilt_id)[var] # WSI, e.g. '0-20000-0-06260'\n", " das.squeeze(drop=True).plot(ax=ax, marker=\"x\", color=\"C1\", label=\"Open Data\")\n", " ax.legend()\n", " ax.set_title(\n", " f\"{var} — {da.attrs.get('long_name', var)} ({da.attrs.get('units', '?')})\"\n", " )\n", " ax.grid(alpha=0.3)\n", "fig.suptitle(f\"Daily values at De Bilt, {START.date()} to {END.date()}\");" ] }, { "cell_type": "markdown", "id": "7f42d4e0", "metadata": { "papermill": { "duration": 0.00279, "end_time": "2026-11-10T11:28:41.543145+00:00", "exception": false, "start_time": "2026-11-10T11:28:41.540355+00:00", "status": "completed" }, "tags": [] }, "source": [ "### Method 2: nearest station to coordinates\n", "\n", "`/locations` returns a GeoJSON FeatureCollection — one feature per station,\n", "with coordinates and metadata (the station id is the feature `id`, e.g. the\n", "WSI `0-20000-0-06260` for De Bilt). `nearest_location()` picks the closest\n", "station client-side (haversine over `/locations`) and always answers.\n", "`position(..., coords=...)` is the server-side alternative: it matches the\n", "nearest station too, but only within a tolerance and 404s (\"no stations\")\n", "when nothing is close — caught and printed below for comparison." ] }, { "cell_type": "code", "execution_count": 9, "id": "375aa017", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:41.549824Z", "iopub.status.busy": "2026-11-10T11:28:41.549485Z", "iopub.status.idle": "2026-11-10T11:28:41.647107Z", "shell.execute_reply": "2026-11-10T11:28:41.646196Z" }, "papermill": { "duration": 0.101862, "end_time": "2026-11-10T11:28:41.647731+00:00", "exception": false, "start_time": "2026-11-10T11:28:41.545869+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "77 measurement locations; first 3:\n", " id=0-20000-0-06201: D15-FA-1 at [2.9358, 54.3256]\n", " id=0-20000-0-06203: P11-B at [3.3417, 52.36]\n", " id=0-20000-0-06204: K14-FA-1C at [3.6278, 53.2694]\n" ] } ], "source": [ "locations = client.edr.locations(COLLECTION)\n", "features = locations.get(\"features\", [])\n", "print(f\"{len(features)} measurement locations; first 3:\")\n", "for feat in features[:3]:\n", " props = feat.get(\"properties\", {})\n", " name = props.get(\"name\") or props.get(\"label\")\n", " print(f\" id={feat.get('id')}: {name} at {feat['geometry']['coordinates']}\")" ] }, { "cell_type": "markdown", "id": "46973526", "metadata": { "papermill": { "duration": 0.003068, "end_time": "2026-11-10T11:28:41.654769+00:00", "exception": false, "start_time": "2026-11-10T11:28:41.651701+00:00", "status": "completed" }, "tags": [] }, "source": [ "Transform the features to a GeoDataFrame, change the crs from wgs84 to rd (EPSG:28992)." ] }, { "cell_type": "code", "execution_count": 10, "id": "90ea9284", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:41.661595Z", "iopub.status.busy": "2026-11-10T11:28:41.661353Z", "iopub.status.idle": "2026-11-10T11:28:41.914345Z", "shell.execute_reply": "2026-11-10T11:28:41.913590Z" }, "papermill": { "duration": 0.258217, "end_time": "2026-11-10T11:28:41.915851+00:00", "exception": false, "start_time": "2026-11-10T11:28:41.657634+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
geometrynametypewmoIdheight_above_mean_sea_level
id
0-20000-0-06201POINT (-4516.392 707290.173)D15-FA-1Platform0620142.70
0-20000-0-06203POINT (15673.472 487756.215)P11-BPlatform0620341.84
0-20000-0-06204POINT (37622.546 588418.735)K14-FA-1CPlatform0620441.80
0-20000-0-06205POINT (55026.11 825236.716)A12-CPPPlatform0620548.35
0-20000-0-06206POINT (65070.734 682161.061)F16-APlatform/AWS0620643.40
..................
0-528-0-06236POINT (134893.205 483082.276)MuidenFog station06236-0.90
0-528-0-06237POINT (104513.338 474364.278)Nieuw-VennepFog station06237-4.80
0-528-0-06238POINT (112416.776 462762.781)NieuwkoopFog station06238-5.77
0-528-0-06317POINT (-6091.025 414938.229)Borssele AlphaPlatform0631743.42
0-528-0-06392POINT (201458.983 388864.477)HorstMeteo site0639221.88
\n", "

77 rows × 5 columns

\n", "
" ], "text/plain": [ " geometry name type \\\n", "id \n", "0-20000-0-06201 POINT (-4516.392 707290.173) D15-FA-1 Platform \n", "0-20000-0-06203 POINT (15673.472 487756.215) P11-B Platform \n", "0-20000-0-06204 POINT (37622.546 588418.735) K14-FA-1C Platform \n", "0-20000-0-06205 POINT (55026.11 825236.716) A12-CPP Platform \n", "0-20000-0-06206 POINT (65070.734 682161.061) F16-A Platform/AWS \n", "... ... ... ... \n", "0-528-0-06236 POINT (134893.205 483082.276) Muiden Fog station \n", "0-528-0-06237 POINT (104513.338 474364.278) Nieuw-Vennep Fog station \n", "0-528-0-06238 POINT (112416.776 462762.781) Nieuwkoop Fog station \n", "0-528-0-06317 POINT (-6091.025 414938.229) Borssele Alpha Platform \n", "0-528-0-06392 POINT (201458.983 388864.477) Horst Meteo site \n", "\n", " wmoId height_above_mean_sea_level \n", "id \n", "0-20000-0-06201 06201 42.70 \n", "0-20000-0-06203 06203 41.84 \n", "0-20000-0-06204 06204 41.80 \n", "0-20000-0-06205 06205 48.35 \n", "0-20000-0-06206 06206 43.40 \n", "... ... ... \n", "0-528-0-06236 06236 -0.90 \n", "0-528-0-06237 06237 -4.80 \n", "0-528-0-06238 06238 -5.77 \n", "0-528-0-06317 06317 43.42 \n", "0-528-0-06392 06392 21.88 \n", "\n", "[77 rows x 5 columns]" ] }, "execution_count": 10, "metadata": {}, "output_type": "execute_result" } ], "source": [ "import geopandas as gpd\n", "\n", "for feature in features:\n", " feature[\"properties\"][\"id\"] = feature[\"id\"]\n", "gdf = gpd.GeoDataFrame.from_features(features, crs=4326).to_crs(28992).set_index(\"id\")\n", "gdf" ] }, { "cell_type": "markdown", "id": "b4fbb3c4", "metadata": { "papermill": { "duration": 0.004022, "end_time": "2026-11-10T11:28:41.924180+00:00", "exception": false, "start_time": "2026-11-10T11:28:41.920158+00:00", "status": "completed" }, "tags": [] }, "source": [ "Plot the location of all Meteo sites with x coordinate greater than 0 (to exclude the points in the Caribbean)." ] }, { "cell_type": "code", "execution_count": 11, "id": "746767c9", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:41.931365Z", "iopub.status.busy": "2026-11-10T11:28:41.930976Z", "iopub.status.idle": "2026-11-10T11:28:42.143268Z", "shell.execute_reply": "2026-11-10T11:28:42.142426Z" }, "papermill": { "duration": 0.216699, "end_time": "2026-11-10T11:28:42.143875+00:00", "exception": false, "start_time": "2026-11-10T11:28:41.927176+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "mask = (gdf[\"type\"] == \"Meteo site\") & (gdf.geometry.x > 0)\n", "ax = gdf[mask].plot(figsize=(5, 10))\n", "for id in gdf.index[mask]:\n", " ax.annotate(\n", " gdf.at[id, \"wmoId\"],\n", " xy=(gdf.loc[id].geometry.x, gdf.loc[id].geometry.y),\n", " )" ] }, { "cell_type": "code", "execution_count": 12, "id": "1164aa2c", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:42.152889Z", "iopub.status.busy": "2026-11-10T11:28:42.152680Z", "iopub.status.idle": "2026-11-10T11:28:42.253084Z", "shell.execute_reply": "2026-11-10T11:28:42.252026Z" }, "papermill": { "duration": 0.105624, "end_time": "2026-11-10T11:28:42.253917+00:00", "exception": false, "start_time": "2026-11-10T11:28:42.148293+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Nearest to (5.18, 52.1): De Bilt (id=0-20000-0-06260, 0.12 km)\n" ] } ], "source": [ "nearest = client.edr.nearest_location(COLLECTION, coords=STATION_COORDS)\n", "de_bilt_id = str(nearest[\"id\"])\n", "print(\n", " f\"Nearest to {STATION_COORDS}: {nearest['name']} (id={de_bilt_id}, \"\n", " f\"{nearest['distance_km']:.2f} km)\"\n", ")" ] }, { "cell_type": "code", "execution_count": 13, "id": "30fceef7", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:42.262751Z", "iopub.status.busy": "2026-11-10T11:28:42.262545Z", "iopub.status.idle": "2026-11-10T11:28:42.356807Z", "shell.execute_reply": "2026-11-10T11:28:42.355975Z" }, "lines_to_next_cell": 0, "papermill": { "duration": 0.099361, "end_time": "2026-11-10T11:28:42.357534+00:00", "exception": false, "start_time": "2026-11-10T11:28:42.258173+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "get_position -> HTTP 404: KNMI API request to https://api.dataplatform.knmi.nl/edr/v1/collections/daily-in-situ-meteorological-observations/position failed with HTTP 404. Response: The query returned no stations\n" ] } ], "source": [ "from knmidata import KNMIHTTPError\n", "\n", "try:\n", " ts_position = client.edr.get_position(\n", " COLLECTION,\n", " coords=STATION_COORDS,\n", " start_time=START,\n", " end_time=END,\n", " parameters=PARAMETERS,\n", " )\n", " print(\"Position query (server-side nearest):\")\n", " print(ts_position)\n", "except KNMIHTTPError as err:\n", " # /position does server-side nearest matching within a tolerance; for this\n", " # station collection a point query can 404 — use method 2 instead.\n", " print(f\"get_position -> HTTP {err.status_code}: {err}\")" ] }, { "cell_type": "markdown", "id": "f92c4b8e", "metadata": { "papermill": { "duration": 0.003466, "end_time": "2026-11-10T11:28:42.365477+00:00", "exception": false, "start_time": "2026-11-10T11:28:42.362011+00:00", "status": "completed" }, "tags": [] }, "source": [ "### Method 3: area — all stations in a bounding box\n", "\n", "`area` takes a bbox and returns every station inside it (a CoverageCollection\n", "of per-station coverages). `knmidata` merges them along a `station` dimension\n", "whose coordinate values are the station ids (WSI, e.g. '0-20000-0-06260') with\n", "`lon`/`lat` coordinates, so you can always tell which entry belongs to which\n", "station: `area[\"TG\"].sel(station=\"0-20000-0-06260\")`." ] }, { "cell_type": "code", "execution_count": 14, "id": "8be4480a", "metadata": { "execution": { "iopub.execute_input": "2026-11-10T11:28:42.373212Z", "iopub.status.busy": "2026-11-10T11:28:42.373004Z", "iopub.status.idle": "2026-11-10T11:28:42.531060Z", "shell.execute_reply": "2026-11-10T11:28:42.530266Z" }, "papermill": { "duration": 0.163225, "end_time": "2026-11-10T11:28:42.532063+00:00", "exception": false, "start_time": "2026-11-10T11:28:42.368838+00:00", "status": "completed" }, "tags": [] }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "All stations within the NL bounding box:\n", " Size: 10kB\n", "Dimensions: (station: 39, time: 8)\n", "Coordinates:\n", " * station (station)