---
title: "Google Air Quality"
description: "Google Air Quality is a built-in integration for Home Assistant. It has 875 installs sharing analytics and needs the vendor's cloud."
canonical: "https://vulpo.app/integrations/core/google-air-quality"
url: "https://vulpo.app/integrations/core/google-air-quality.md"
last-updated: "2026-10-22"
version: "1.4"
---

# Google Air Quality

> Google Air Quality is a built-in integration for Home Assistant. It has 875 installs sharing analytics and needs the vendor's cloud.

Google Air Quality is a built-in integration that reads air quality data for a chosen location from Google's cloud service. It adds sensors for pollutants such as ammonia, benzene and non-methane hydrocarbons, along with the air quality index, its category and the dominant pollutant. Universal Air Quality Index values, with their own category and dominant pollutant, are also provided. A custom local air quality index can be enabled, based on a target index and the country of the location. An action returns an air quality forecast for a configured location. Setup is done in the UI with an API key tied to a Google billing account, plus the location coordinates and a name.

Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=google_air_quality)

## Supports

- **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Bronze quality**: Home Assistant's own rating of its code and setup experience.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

It is added under Settings, Devices and services, with Add integration.

### Connect

- **API key**: A unique alphanumeric string that associates your Google billing account with Google Air Quality API
- **Location**: Location coordinates
- **Name**: Location name
- **HTTP referrer**
- **Country**: Country of the location
- **Custom local AQI**: The target air quality index
- **Enable custom local AQI**: Select to enable a custom local air quality index

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Sensors**: Ammonia, Benzene, AQI, Category, Dominant pollutant, Non-methane hydrocarbons, Universal Air Quality Index, UAQI category, UAQI dominant pollutant

## Actions

- **Get forecast**: Get an air quality forecast for a configured location.
  Fields: Location, Hours

## At a glance

- Kind: Built-in integration
- Category: [Sensors](https://vulpo.app/integrations/category/sensors.md), Air quality
- Brand: [Google](https://vulpo.app/integrations/google.md)
- Number: 875 installs sharing analytics
- Connection: Needs the vendor's cloud
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Quality scale: Bronze quality scale
- Domain: `google_air_quality`
- Source: <https://www.home-assistant.io/integrations/google_air_quality/>

In Vulpo: Chart card, Apple Watch

## Other ways in for Google

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [Google Translate text-to-speech](https://vulpo.app/integrations/core/google-translate.md) | Built-in integration | 524k installs sharing analytics | Needs the vendor's cloud | Part of Home Assistant |
| [Google Cast](https://vulpo.app/integrations/core/cast.md) | Built-in integration | 288k installs sharing analytics | Works locally | Part of Home Assistant |
| [Google Calendar](https://vulpo.app/integrations/core/google.md) | Built-in integration | 42.6k installs sharing analytics | Needs the vendor's cloud | Part of Home Assistant |
| [Google Gemini](https://vulpo.app/integrations/core/google-generative-ai-conversation.md) | Built-in integration | 36.3k installs sharing analytics | Needs the vendor's cloud | Part of Home Assistant |
| [Google Nest](https://vulpo.app/integrations/core/nest.md) | Built-in integration | 21.3k installs sharing analytics | Needs the vendor's cloud | Part of Home Assistant |

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/google-air-quality

---

- HTML version of this page: https://vulpo.app/integrations/core/google-air-quality
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml
