diff --git a/source/_integrations/google_air_quality.markdown b/source/_integrations/google_air_quality.markdown new file mode 100644 index 00000000000..04de20ce2c1 --- /dev/null +++ b/source/_integrations/google_air_quality.markdown @@ -0,0 +1,94 @@ +--- +title: Google Air Quality +description: Instructions on how to integrate Google Air Quality into Home Assistant. +ha_category: + - Sensor +ha_release: 2025.12 +ha_iot_class: Cloud Poll +ha_config_flow: true +ha_codeowners: + - '@Thomas55555' +ha_platforms: + - sensor +ha_integration_type: integration +ha_domain: google_air_quality +ha_quality_scale: bronze +--- + +The **Google Air Quality** {% term integration %} provides Air quality data through the Google Air Quality API. + +## Prerequisites + +You need an API key. Follow the instructions [in the Google developer documentation](https://developers.google.com/maps/documentation/air-quality/get-api-key) for creating an API key. +Additionally, you have to create a *Billing Account*. At the time of writing this documentation, Google allows 10,000 API calls per month for free. + +{% important %} +This integration polls every 60 minutes. Here is an overview about how many API calls are performed per month in dependence of the amount of coordinates: + +Coordinates | API calls per month +----------- | ------------------- +1 | 800 +2 | 1,600 +3 | 2,400 +4 | 3,200 +5 | 4,000 +10 | 8,000 +12 | 9,600 + +Consider each restart of Home Assistant is an additional API call, per coordinate/entry. + +You can set up a [budget](https://cloud.google.com/billing/docs/how-to/budgets) for your billing account. This does not limit your costs, but you can get an alert when you reach the budget. +You may want to setup [disable billing with notifications](https://cloud.google.com/billing/docs/how-to/disable-billing-with-notifications). This can still produce costs between incurring costs and receiving budget notifications. + +Make sure to monitor the cost. If you make too many requests, you will be charged for it. The integration cannot monitor it for you. +{% endimportant %} + +{% include integrations/config_flow.md %} + +## Supported functionality + +### Sensor + +The integration will create the following sensors: +For your local air quality you can find more details [here](https://developers.google.com/maps/documentation/air-quality/laqis) + +- **Universal Air Quality Index (UAQI)** + *The global air quality index provided by Google. Ranges from 0 (worst) to 100 (best).* + +- **UAQI Category** + *Descriptive category for UAQI. Possible values include: Excellent air quality, Good air quality, Moderate air quality, Low air quality, Poor air quality.* + +- **UAQI Dominant Pollutant** + *The pollutant that most significantly influences the UAQI value. Possible values include: PM2.5, PM10, Ozone (O₃), Nitrogen Dioxide (NO₂), Sulphur Dioxide (SO₂), Carbon Monoxide (CO)* + +- **Local Air Quality Index** + *A regionally calibrated AQI value, where available.* + +- **Local Category** + *Descriptive category for the local AQI. The values can differ from the ones set as UAQI Category.* + +- **Local Dominant Pollutant** + *The pollutant that most significantly influences the local AQI. The values can differ from the ones set as UAQI Dominant Pollutant.* + +- **PM2.5** + *Particulate matter smaller than 2.5 µm in diameter.* + +- **PM10** + *Particulate matter smaller than 10 µm in diameter.* + +- **Ozone (O₃)** + *Ground-level ozone concentration.* + +- **Nitrogen Dioxide (NO₂)** + *Nitrogen dioxide concentration.* + +- **Sulphur Dioxide (SO₂)** + *Sulphur dioxide concentration.* + +- **Carbon Monoxide (CO)** + *Carbon monoxide concentration.* + +## Removing the integration + +{% include integrations/remove_device_service.md %} +