2026.1.0
Home ▸ Integrations ▸

GIOŚ

The GIOŚ integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] uses the GIOŚ web service as a source for air quality data for your location.

Use cases

  • Monitor outdoor air quality.
  • Warn to close windows when air quality is poor.
  • Control ventilation systems based on air quality.

Configuration

To add the GIOŚ 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:

Measuring station

Select a measuring station from the list.

Supported functionality

Below is a complete overview of the entities this integration provides.

Available sensors

The integration provides the following sensors:

  • Air quality index
  • Benzene
  • Carbon monoxide
  • Nitrogen dioxide
  • Nitrogen dioxide index
  • Nitrogen monoxide
  • Nitrogen oxides
  • Ozone
  • Ozone index
  • PM10
  • PM10 index
  • PM2.5
  • PM2.5 index
  • Sulphur dioxide
  • Sulphur dioxide index

The available sensors and data refresh rate depend on the selected measurement station.

Data updates

By default, the integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] data from the API every 30 minutes.

Examples

The following examples show how to use the integration in Home Assistant automations. These examples are just a starting point, and you can use them as inspiration to create your own automations.

Notify when the PM10 level is too high

The following example sends a notification to your mobile device when the PM10 level exceeds 100 µg/m³.

automation:
  - alias: "Notify when PM10 level is too high"
    triggers:
      - trigger: numeric_state
        entity_id: sensor.czerniawa_pm10
        above: 100

    actions:
      - action: notify.mobile_app_your_device
        data:
          title: "High PM10 Level Alert"
          message: >
            The PM10 level is too high at {{ states('sensor.czerniawa_pm10') }} µg/m³.
            Avoid going outside.

Troubleshooting

Before reporting an issue, enable debug logging and restart the integration. As soon as the issue re-occurs, stop the debug logging again (download of debug log file will start automatically). Further, if still possible, download the diagnosticsThe diagnostics integration provides a way to download diagnostic data from a device or integration for sharing in issue reports. Sharing diagnostics data when reporting an issue allows developers to diagnose and fix your reported problem quicker. [Learn more] data. If you have collected the debug log and the diagnostics data, include them in the issue report.

Removing the integration

This integration follows standard integration removal, no extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.