NL Weather is a Home Assistant integration that provides weather forecasts, observations, precipitation (e.g. rain) radar and warnings in The Netherlands — using open data directly fetched from KNMI (the Royal Netherlands Meteorological Institute).

Using default cards and radar in bright color theme

In this screenshot the custom card Weather Forecast Extended is used to display the forecast, warnings and observations. For the radar image the “Picture with entity” card is used.

• Integration as a Home Assistant weather entity provider
  • Observations and forecast separated into two weather entities
• Can have multiple configurable locations (limited to the Netherlands) with
  • Current weather observations (temperature, humidity, wind, etc.)
  • Weather forecast (hourly/daily)
  • Weather alerts (issued by KNMI)
• Precipitation / rain radar and forecast (rain intensity, movement, etc.)
  • Can mark home location on the radar image
  • Radar has a dark and light color theme
• Weather observations can be fetched in two modes
  1. Manually select a weather station
  2. Automatically fetch the closest observations from one or more weather station
• Data fetched directly from official KNMI APIs
  • Requires account at KNMI Data Platform
  • Uses KNMI's MQTT Notification Service to reduce polling

1. Ensure you have HACS installed in your Home Assistant.
2. Search for NL Weather and install.
3. Restart Home Assistant if required.

If you prefer manual install (or HACS is not available):

1. Download or clone this repository.
2. Copy the folder custom_components/nl_weather to your Home Assistant custom_components/ directory.
3. Restart Home Assistant.

After adding the integration you'll first need to configure your API keys.

You can get API keys from https://developer.dataplatform.knmi.nl/. Register an account and request keys for:

1. EDR API
2. Web Map Service (WMS)
3. Notification Service

You'll receive copies of all keys via e-mail as well.

Add the integration via Settings → Devices & Services → Add Integration → NL Weather

A form is shown where you can enter your API keys for:

1. EDR API
2. Web Map Service (WMS)
3. Notification Service (MQTT)

To start receiving weather observations and forecasts, add a location: Settings → Devices & services → NL Weather → Add location

Enter (or modify) the GPS coordinates of your location. The region you set will determine for which region you will receive weather alerts.

The integration creates the following entities for each configured location:

• weather.weer_{location}_observations for current weather observations
• weather.weer_{location}_forecast for the weather forecast

• Weather alert text and alert level
• Forecast temperature sensors for today's and tomorrow's highs and lows
• Observations
  • Temperature (air at 1.5 m and 10 cm and soil at -10 cm)
  • Relative humidity
  • Dew point
  • Visibility
  • Air pressure at mean sea level
  • Wind speed
  • Wind gusts
  • Wind direction (in degrees and cardinal)
  • Cloud coverage
  • Cloud ceiling
  • Sunshine duration
  • Solar radiation
• Observation time, station distance, and station name as diagnostic sensors

Available observation sensors depend on the selected weather station. Airport stations usually provide the most complete set of measurements. More information about observations can be found in KNMI documentation.

When using automatic station selection, observation values can come from multiple nearby stations (per parameter). In that case:

• Station name shows all contributing stations, ordered by how often they were used
• Station distance shows the distance that was used most often
• Observation time shows the most frequent observation timestamp among contributing stations

This allows you to use the data in automations, dashboards, and scripts just like with any other weather integration.

Contributions, bug reports, feature requests are welcome. Feel free to open an issue or submit a pull request.

Apache License, Version 2.0

• Forecast, weather observations, radar and weather warnings provided by Koninklijk Nederlands Meteorologisch Instituut (KNMI) licensed under CC-BY 4.0

For further help or discussion you can use this Home Assistant Community Forum thread.

Thank you for using NL Weather! If you like it, please consider starring the repo ⭐