Files
2026-10-15 20:38:02 +02:00

22 lines
3.1 KiB
Markdown

# Buienradar widget
Verified 14 October 2026 against Buienradar's [Gratis Weerdata](https://www.buienradar.nl/overbuienradar/gratis-weerdata) page and live endpoint responses.
## Setup
**No API key or account is needed** for the documented free-data feed and embeds used here. Add **Rain radar** from the dashboard widget catalogue. It starts with Heerenveen; select **Use my location** or enter coordinates manually. The local forecast covers locations in the Netherlands.
Buienradar says its free data may be used for qualifying non-commercial websites or intranets with a visible `Buienradar.nl` source link. Mobile applications and commercial use require provider permission. This dashboard is an authenticated internal website, not a mobile app. Recheck terms or obtain permission before commercial or public use.
## Sources and behavior
- Local two-hour forecast: `https://gps.buienradar.nl/getrr.php?lat=…&lon=…`, documented on the free-data page. It returns rain codes at five-minute timestamps. The adapter uses Buienradar's documented formula `10^((value-109)/32)` to convert nonzero codes to mm/h. Zero means dry. At saturated high codes, the UI shows heavy rain without an exact mm/h estimate. The **None / Light / Moderate / Heavy** bands are presentation categories chosen by this project, not provider labels.
- Radar snapshot: Buienradar's documented `https://image.buienradar.nl/2.0/image/single/RadarMapRainNL` embed, with branding and text enabled. The widget also uses its official `https://gadgets.buienradar.nl/gadget/radarfivedays` iframe for animation after the user presses Play. The iframe manages its own frames. Pause switches back to the latest static image; it does not freeze a particular frame. Full screen opens a local dialog, or the Buienradar site where dialogs are unavailable.
- No radar frame URLs are extracted, proxied, stored, or synchronized to forecast values. The official embed does not provide frame timestamps or seek controls to this application. The slider and Previous/Next buttons move through **forecast** points only. The UI labels this distinction.
- The Django forecast adapter shares a file cache among server workers: five-minute fresh interval, up-to-15-minute stale fallback, and a short lock to avoid duplicate upstream requests. It sends rounded coordinates to the provider. Browser coordinates stay in page memory and are submitted to Django via authenticated CSRF-protected POST; they are not saved in widget settings. The radar image and gadget are loaded directly from Buienradar, so the provider sees the browser's IP address.
- The radar image has no reliable user-location marker or frame timestamp, so neither is claimed. The forecast source is separate from the weather model in the Open-Meteo widget; the two may differ.
## Attribution and limits
The widget displays a visible link to [Buienradar.nl](https://www.buienradar.nl/). The free-data page says radar images update about every five minutes; no numerical request quota was published there. The implementation refreshes the local forecast every five minutes while mounted. Availability and forecasts are not guaranteed. Recheck the source page before public or commercial deployment.