Stookwijzer

The Stookwijzer integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] queries the Atlas Leefomgeving Stookwijzer API for windspeed and air quality index. Based on these values, Stookwijzer advises people not to burn pallets or wood or use barbecues. This can help prevent health issues for people in the area.

The state can provide three different levels of recommendations:

  • Code Yellow: Please note: burning wood causes discomfort and air pollution.
  • Code Orange: It is recommended not to burn wood now.
  • Code Red: Do not burn wood now.

Additionally, various sensor entities are provided:

  • Windspeed: Sensor containing the current windspeed at the selected location.
  • Air Quality Index: Sensor containing the air quality index at the selected location.

Configuration

To add the Stookwijzer service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Stookwijzer.

  • Follow the instructions on screen to complete the setup.

Action: Get Forecast

The stookwijzer.get_forecast action populates response data with a mapping of the Stookwijzer advice forecast.

action: stookwijzer.get_forecast
target:
  config_entry_id: 12345
response_variable: stookwijzer_forecast

The response data field contains the forecast field. forecast is a list of forecast advice entries at a given time:

Response data Description Example
datetime The time of the forecasted advice. 2025-01-14T14:00:00+00:00
advice The forecasted advice code. code_yellow
final Indicator whether the advice is final or can still change. True
Example action response
forecast:
  - datetime: "2025-02-12T17:00:00+01:00"
    advice: code_yellow
    final: True
  - datetime: "2025-02-12T23:00:00+01:00"
    advice: code_yellow
    final: True
  - datetime: "2025-02-13T05:00:00+01:00"
    advice: code_orange
    final: False
  - datetime: "2025-02-13T11:00:00+01:00"
    advice: code_red
    final: False

Examples

Example template sensor using get_forecast

Example template sensors containing the Stookwijzer forecast for 6 and 12 hours from now.

template:
  - trigger:
      - trigger: time_pattern
        hours: /1
    action:
      - action: stookwijzer.get_forecast
        target:
          entity_id: sensor.stookwijzer_advice_code
        response_variable: advice_forecast
    sensor:
      - name: Stookwijzer forecast 6 hours
        unique_id: stookwijzer_forecast_6_hours
        state: "{{ advice_forecast['forecast'][0]['advice'] }}"
        attributes:
          final: "{{ advice_forecast['forecast'][0]['final'] }}"
          timestamp: "{{ advice_forecast['forecast'][0]['datetime'] }}"
      - name: Stookwijzer forecast 12 hours
        unique_id: stookwijzer_forecast_12_hours
        state: "{{ advice_forecast['forecast'][1]['advice'] }}"
        attributes:
          final: "{{ advice_forecast['forecast'][1]['final'] }}"
          timestamp: "{{ advice_forecast['forecast'][1]['datetime'] }}"