# Air quality card

> Canonical HTML: https://screenrig.ai/docs/cards/air-quality/

The air quality index on a coloured dial, with pollutants, UV and the days ahead. The host supplies the readings.

Category: Weather. Tags: Weather and environment, Numbers and metrics.

## Previews

![Air quality](/cards/air-quality/v1/screenshots/canvas-bloom.webp?sha=665a2fcad2ca1ce8d88597eb9a3ffb1b3be8f5629a2dc22e3edb163eec55dee7)

Canvas

![Air quality](/cards/air-quality/v1/screenshots/corner-bloom.webp?sha=fd5d411207d05165bcc8289bfdffd7ac20e1e51961dcbe3c0435efd0a61a6ada)

Corner

![Air quality](/cards/air-quality/v1/screenshots/chip-bloom.webp?sha=e9ab04f6ee05f5edf44b03d1d3de538b7498ad202a1d0a0400b0201c784c1ec3)

Chip

## Views and forms

Views: canvas, corner, chip. Canvas forms: landscape, portrait, strip.

[Card views, themes and publishing](/docs/cards/). [Browse the gallery](/apps/#cards).

## Data and privacy

Feed: `screenrig.airquality/v1`.

Feed documents carry source attribution. The Player supplies the feed to the card.

## Properties

For theme, background, accent and position, see [Common properties](/docs/cards/#common-properties).

Set static properties in `params`. Bind `data` to a project card data key for live values; that document holds only dynamic properties. Without a data key, put the complete configuration in `params`. Nested rows describe the contents of their parent property.

### Static properties

| Name | Type | Default | Values and limits | Description |
| --- | --- | --- | --- | --- |
| `title` | string | `""` | maxLength: `40` | Empty uses the location name. |
| `scale` | string | `"us-epa"` | `"us-epa"` |  |
| `showPollutants` | boolean | `true` |  |  |
| `hour12` | boolean | `false` |  |  |
| `timeZone` | string, null | `null` |  |  |
| `location` | object |  | additionalProperties: `false` | Place the readings are for. Selects the feed. |
| `location.name` | string |  | maxLength: `40`; Required |  |
| `location.latitude` | number |  | minimum: `-90`; maximum: `90`; Required |  |
| `location.longitude` | number |  | minimum: `-180`; maximum: `180`; Required |  |

### Dynamic properties

This card has no dynamic properties.

## Canvas example

Add this item to a playlist page’s `primitives`. [Publish the playlist and assign a screen](/docs/cards/#publish-a-card-canvas).

```json
{
  "id": "air-quality",
  "primitive": "card",
  "card": "air-quality",
  "major": 1,
  "params": {
    "theme": "neomustard",
    "location": {
      "name": "Vancouver",
      "latitude": 49.25,
      "longitude": -123.0
    }
  },
  "rect": {
    "x": 0,
    "y": 0,
    "width": 1920,
    "height": 1080
  },
  "layer": 0,
  "content_fit": "fill"
}
```