home-assistant.io/source/_integrations/stookwijzer.markdown

title	description	ha_category	ha_release	ha_iot_class	ha_codeowners	ha_domain	ha_config_flow	ha_platforms	ha_integration_type
Stookwijzer	Instructions on how to use Stookwijzer data within Home Assistant	Environment Sensor	2023.2	Cloud Polling	@fwestenberg	stookwijzer	true	diagnostics sensor	service

The Stookwijzer {% term integration %} 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.

{% include integrations/config_flow.md %}

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

{% details "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

{% enddetails %}

Examples

{% details "Example template sensor using get_forecast" %}

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

{% raw %}

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'] }}"

{% endraw %}

{% enddetails %}