2025.12.0
Home ▸ Integrations ▸

Google Air Quality

The Google Air Quality integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides Air quality data through the Google Air Quality API.

Prerequisites

You need an API key. Follow the instructions in the Google developer documentation 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 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. 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.

Configuration

To add the Google Air Quality integration 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 Google Air Quality.

  • Follow the instructions on screen to complete the setup.

Supported functionality

Sensor

The integration will create the following sensors: For your local air quality you can find more details here

  • 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

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.