This custom component for Home Assistant integrates weather data (measurements and forecasts) from the Deutscher Wetterdienst Open Data server into Home Assistant via weather entities.
Deutscher Wetterdienst (DWD) is not affiliated in any way with this project.
The conditions from Deutscher Wetterdienst (DWD) for using their data and accessing their servers apply.
stations.md and custom_components/dwd/stations.json are generated from data from Deutscher Wetterdienst (DWD) with the Python script at tools/generate_stations/generate_stations.py.
- Current measurement data from the weather stations from https://opendata.dwd.de/weather/weather_reports/poi/ as state attributes of a weather entity.
- condition
- temperature
- dew_point
- cloud_coverage
- humidity
- pressure
- visibility
- wind_gust_speed
- wind_speed
- wind_bearing
- Hourly forecast data from the weather stations from https://opendata.dwd.de/weather/local_forecasts/mos/MOSMIX_L/single_stations/ in the forecast list of a weather entity.
- datetime
- condition
- temperature
- dew_point
- cloud_coverage
- precipitation
- precipitation_probability
- pressure
- wind_gust_speed
- wind_speed
- wind_bearing
- Daily forecast data calculated by the component from the hourly forecast data. This is the most tricky part. I have compared the result of this with what the official Warnwetter app displays and the results seems to be very close.
- datetime
- condition
- temperature (the maximum temperature for the day)
- templow (the minimum temperature for the day)
- cloud_coverage (arithmetic average over the day)
- precipitation (sum over the day)
- pressure (arithmetic average over the day)
- wind_gust_speed (maximum over the day)
- wind_speed (arithmetic average over the day)
- Uses the HTTP ETag mechanism to only download new data if the data has changed. This allows more frequent polling (currently about every 10 minutes) while still keeping the load low.
- Configuration via UI
This quick setup guide is based on My Home Assistant links and the Home Assistant Community Store (HACS). For more details and other setup methods, see setup.md.
As this integration is currently not part of Home Assistant Core, you have to download it first into your Home Assistant installation. To download it via HACS, click the following button to open the download page for this integration in HACS.
After a restart of Home Assistant, this integration is configurable by via "Add Integration" at "Devices & Services" like any core integration. Select "Deutscher Wetterdienst" and follow the instructions.
To get there in one click, use this button:
This adds one device and three entities for the selected station. By default, only the entity that provides all forecasts in one entity is enabled. If you still need the deprecated weather entities with daily and houry forecasts separately or via the old mechanism, you can still enable them for now, but you should really switch to the new entity now. To add more stations, just repeat the "Add Integration" step.
If you have questions, they might already be answered at questions_and_answers.md.
Unfortunately, most of the following documentation is only available in German.
- Deutscher Wetterdienst Open Data.
- List of documents related to Deutscher Wetterdienst Open Data, e.g. documents that describe the various file formats. The most relevant ones used during development of this component are listed below.
- Explanation of the elements used in the MOSMIX forecast KML files.
- Explanation of the weather codes (ww, ww3, WPc11, WPc31, WPc61, WPcd1, WPch1 and W1W2) used in the MOSMIX forecast KML files.
- Binary Codes (BUFR). Actually, this should not be so much relevant, because everything should be covered by the previous documents, but there is some interesting overlap with the table "Aktuelles Wetter" on page 229 of this document.
- General explanation of forecast symbols. This doesn't explain the data format, but it is still quite interesting, because it shows the relations of the symbols to other data like cloud coverage and precipitation.
For more information about stations see also stations.md.
