Skip to content

Custom component for Home Assistant that integrates weather data (measurements and forecasts) of Deutscher Wetterdienst (DWD).

License

Notifications You must be signed in to change notification settings

hg1337/homeassistant-dwd

Repository files navigation

Release Hassfest Workflow Status License Donation
Open your Home Assistant instance and open this repository inside the Home Assistant Community Store. Open your Home Assistant instance and start setting up this integration.

Deutscher Wetterdienst (DWD) Integration for Home Assistant

Screenshot Weather Forecast

Introduction

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.

Legal Information

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.

Main Features

  • 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

Screenshot Entity

Quick Setup

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.

Open your Home Assistant instance and open this repository inside the Home Assistant Community Store.

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.

Screenshot Search Integration

To get there in one click, use this button:

Open your Home Assistant instance and start setting up this integration.

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.

Questions & Answers

If you have questions, they might already be answered at questions_and_answers.md.

References

Unfortunately, most of the following documentation is only available in German.

General

Measurements

Forecasts

Station Lists

For more information about stations see also stations.md.