Simple DWD Weatherforecast

Warnings

• gotcha When fetching hourly data by setting `force_hourly=True`, the library downloads approximately 37MB of data per call. Additionally, this mode may omit some data elements like `PRECIPITATION_PROBABILITY` and `PRECIPITATION_DURATION`.
  Fix: Be mindful of network usage and data completeness when using `force_hourly=True`. Consider if these specific elements are critical for your application.
• gotcha Datetime values provided to library methods must always be in UTC. Providing naive datetimes or datetimes in other timezones can lead to incorrect data retrieval or errors.
  Fix: Always use `datetime.now(timezone.utc)` or ensure any `datetime` objects are explicitly set to UTC before passing them to `simple-dwd-weatherforecast` functions.
• gotcha Weather condition data is returned as a raw digit value provided by DWD. Users are responsible for converting these codes into human-readable conditions, though simplified conversion tables might be available within the library's source code or documentation.
  Fix: Implement a mapping or use an existing utility (if provided by the library) to convert the numerical weather condition codes into descriptive strings.
• gotcha Unexpected `ModuleNotFoundError` for `stream_unzip` or `stream_inflate`, or build failures related to these packages, have been reported in certain environments (e.g., Home Assistant, specific Python versions, or beta builds). This indicates dependency resolution issues.
  Fix: Ensure that `stream-unzip` and `stream-inflate` are correctly installed and compatible with your Python version. Sometimes, upgrading `simple-dwd-weatherforecast` to its latest version (which might include updated dependency specifications) or manually installing specific versions of `stream-unzip`/`stream-inflate` can resolve the issue.

Install

• pip install simple-dwd-weatherforecast Install latest version

Imports

• dwdforecast

  from simple_dwd_weatherforecast import dwdforecast

  Main module for weather forecast data.
• dwdmap

  from simple_dwd_weatherforecast import dwdmap

  Module for retrieving DWD weather maps.

Quickstart

This quickstart demonstrates how to initialize the `Weather` object with a station ID and retrieve current and future temperature forecasts. It also shows how to get the raw weather condition code. Station IDs can be found via `get_nearest_station_id` or from DWD's official lists. All datetime objects passed to the library should be in UTC.

from simple_dwd_weatherforecast import dwdforecast
from datetime import datetime, timezone

# Find nearest Station-ID automatically (uncomment to use)
# id = dwdforecast.get_nearest_station_id(50.1109221, 8.6821267)

# Or use a known Station-ID, e.g., for BERLIN-SCHOENEFELD
station_id = "10385"
dwd_weather = dwdforecast.Weather(station_id)

time_now = datetime.now(timezone.utc)

try:
    temperature_now = dwd_weather.get_forecast_data(dwdforecast.WeatherDataType.TEMPERATURE_2M, time_now)
    print(f"Temperature at {station_id} ({time_now.isoformat()} UTC): {temperature_now}°C")

    # Get a specific forecast for a few hours later
    future_time = time_now.replace(hour=(time_now.hour + 3) % 24) # Example: 3 hours later on the same day
    future_temp = dwd_weather.get_forecast_data(dwdforecast.WeatherDataType.TEMPERATURE_2M, future_time)
    print(f"Temperature at {station_id} ({future_time.isoformat()} UTC): {future_temp}°C")

    # Get weather condition (requires manual conversion from digit value if not using helper)
    weather_condition_code = dwd_weather.get_forecast_data(dwdforecast.WeatherDataType.WEATHER_CONDITION, time_now)
    print(f"Weather condition code: {weather_condition_code}")

except Exception as e:
    print(f"An error occurred: {e}")
    print("Ensure the station ID is valid and DWD data is available for the requested time.")