ioBroker.airly

Adapter reading air quality data (PM2.5, PM10, CAQI index) for your location from Airly.

Sentry

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

Configuration

| Setting | Meaning | | ---------------- | --------------------------------------------------------------- | | apikey | Airly API key (developer.airly.org) | | latitude | Your latitude | | longitude | Your longitude | | mode | point — interpolated for your exact coordinates (default); nearest — data from the closest physical station | | maxDistanceKM | Search radius for the closest station (km); only used in nearest mode | | pollInterval | How often to fetch measurements (minutes) |

Each poll makes a single request to Airly's measurements/point (or measurements/nearest) endpoint, which takes your coordinates directly — there is no separate station lookup to manage.

Airly limits its free public API to 100 calls per day — about one call every 15 minutes. Keep pollInterval at 20 minutes or longer (≈72 calls/day) to stay comfortably within the quota. The remaining daily quota is written to the debug log on every poll.

States

| State | Description | | ----------------------- | ---------------------------------------- | | pm25.value | PM2.5 concentration (µg/m³) | | pm25.limitPercent | PM2.5 as % of the norm | | pm10.value | PM10 concentration (µg/m³) | | pm10.limitPercent | PM10 as % of the norm | | caqi.value | CAQI index value | | caqi.level | CAQI level (e.g. LOW, MEDIUM) | | caqi.description | Human-readable air quality description | | info.connection | API reachable / data valid | | info.lastUpdate | Timestamp of the last measurement |

Installation

Open the Adapters tab in the ioBroker admin, find Airly and click the + button to install it and add an instance. Then open the instance settings and fill in your Airly API key and coordinates.

Changelog

0.3.6 (2026-07-11)

• (tnowak) Read coordinates fresh on every poll and skip the request (instead of sending NaN) when they are invalid, logging the offending value; set info.connection = false on stop

0.3.5 (2026-07-08)

• (tnowak) Fixed the jsonConfig schema URL in .vscode/settings.json and bumped @iobroker/adapter-dev

0.3.4 (2026-07-08)

• (tnowak) Addressed repochecker suggestions: short-format i18n, CHANGELOG_OLD.md, .vscode settings, Dependabot automerge + higher PR limit, and @iobroker/adapter-dev

0.3.3 (2026-07-08)

• (tnowak) Removed chai and mocha from devDependencies (provided by @iobroker/testing) to satisfy the repository checker

0.3.2 (2026-07-08)

• (tnowak) Added ESLint (@iobroker/eslint-config), tsconfig, Dependabot and the release-script for development and release automation

Older entries are kept in CHANGELOG_OLD.md.

License

The MIT License (MIT)

Copyright (c) 2026 tnowak [email protected]

See LICENSE for the full text.