{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-azure-maps/json-schema/microsoft-azure-maps-daily-air-quality-forecast-result-schema.json",
  "title": "DailyAirQualityForecastResult",
  "description": "The response returned by the Get Daily Air Quality Forecasts operation,\ncontaining one forecasted air-quality reading per day for the queried\nlocation across the requested forecast horizon. The horizon is set by the\ncaller's requested forecast duration (a `DailyDuration` value of 1, 2, 3,\n4, 5, 6, or 7 days), so `results` carries that many entries in\nchronological order - for example, a 3-day request returns daily readings\nfor *2021-07-18*, *2021-07-19*, and *2021-07-20*. Each entry summarizes\nthe day's expected air quality on the same scales used by the current\nair-quality reading, so it pairs naturally with `AirQualityResult` for\nshowing \"today plus the next several days\" views.",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-azure-maps-weather-api-openapi.yml#/components/schemas/DailyAirQualityForecastResult",
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "The list of forecasted daily air-quality readings for the queried\nlocation, one entry per day, in chronological order starting with the\nearliest forecasted day. The number of entries matches the requested\nforecast duration - for example, a 3-day request returns three entries\nwith `dateTime` values *2021-07-18T07:00:00+00:00*,\n*2021-07-19T07:00:00+00:00*, and *2021-07-20T07:00:00+00:00*. Each\nentry reports the day's `index`, `globalIndex`, `dominantPollutant`,\n`category`, `categoryColor`, and a textual `description`.",
      "items": {
        "$ref": "#/$defs/DailyAirQuality"
      }
    },
    "nextLink": {
      "type": "string",
      "description": "The URL to retrieve the next page of results when the response is\npaginated, suitable for navigating through result sets too large to\nreturn in a single call. Empty when there are no further pages."
    }
  },
  "$defs": {
    "DailyAirQuality": {
      "type": "object",
      "description": "The forecasted air-quality reading for a single day at the queried\nlocation, returned as one entry in `DailyAirQualityForecastResult.results`.\nEach entry summarizes the day's expected air quality on the same scales\nused by `AirQuality` for the current reading - the local AQI (`index`),\nthe internationally normalized index (`globalIndex`), the\n`dominantPollutant`, a short `category` label (for example, *Fair*) and\nmatching `categoryColor` swatch (for example, *#FFC300*), and a textual\n`description` of what the reading means for people. Across the entries\nin a single forecast response the values typically evolve from day to\nday - in the example response *globalIndex* runs *42.2* -> *37* -> *40*\nacross three consecutive days while the dominant pollutant stays\n*Ozone*.",
      "properties": {
        "dateTime": {
          "type": "string",
          "format": "date-time",
          "description": "The day this forecast covers, in [ISO\n8601](https://www.iso.org/iso-8601-date-and-time-format.html) format\n(yyyy-mm-ddThh:mm:ss+hh:mm) - for example,\n*2021-07-18T07:00:00+00:00*. Forecast entries within a single\nresponse use sequential `dateTime` values, one per day."
        },
        "index": {
          "type": "number",
          "format": "float",
          "description": "The forecasted overall air-quality index (AQI) for the day, on the\nscale set by the local regulating body for the queried location. Like\n`AirQuality.index`, this is comparable across days at the same\nlocation - for example, *35.1*, *31.6*, and *33.6* on three\nconsecutive days - but not directly comparable across locations\nbecause each region uses its own scale. Use `category` for a\nlocation-independent label. For background, see [Air quality\nindex](https://en.wikipedia.org/wiki/Air_quality_index) on Wikipedia."
        },
        "globalIndex": {
          "type": "number",
          "format": "float",
          "description": "The forecasted air-quality index on the internationally normalized\n0-to-300+ scale, where higher values denote poorer air quality. The\nscale is the same as `AirQuality.globalIndex`, so values are\ncomparable across locations and across days - for example, *42.2*,\n*37*, and *40* on three consecutive forecast days. The index reflects\nconcentrations of **PM2.5**, **PM10**, **NO2**, **SO2**, **CO**, and\n**O3**."
        },
        "dominantPollutant": {
          "$ref": "#/$defs/DominantPollutant",
          "description": "The pollutant expected to have the highest concentration during the\nday - one of the `DominantPollutant` values, for example *Ozone*.\nThis is the pollutant that typically drives the day's `index` and\n`globalIndex` values."
        },
        "category": {
          "type": "string",
          "description": "A one-word summary of the day's forecasted air quality (for example,\n*Excellent*, *Fair*, or *Poor*), returned in the requested language.\nPairs with `categoryColor` for a quick visual cue and with\n`description` for a longer explanation. Because the label is\nderived from the local AQI bands, it is comparable across locations\neven when raw `index` values are not."
        },
        "categoryColor": {
          "type": "string",
          "description": "The hexadecimal color associated with `category`, suitable for\nstyling a UI swatch or badge - for example, *#FFC300* for *Fair*.\nCategories and colors are consistent across daily forecast entries\nso the same label always renders with the same color."
        },
        "description": {
          "type": "string",
          "description": "A short, human-readable explanation of the day's forecasted air\nquality and any precautions it suggests, returned in the requested\nlanguage - for example, *\"The air quality is generally acceptable\nfor most individuals. However, sensitive groups may experience minor\nto moderate symptoms from long-term exposure.\"* Intended for direct\ndisplay alongside `category` and `categoryColor`."
        }
      }
    },
    "DominantPollutant": {
      "type": "string",
      "description": "Identifies the pollutant with the highest concentration.",
      "enum": [
        "Carbon Monoxide",
        "Nitrogen Dioxide",
        "Ozone",
        "Particulate Matter 2.5",
        "Particulate Matter 10",
        "Sulfur Dioxide"
      ],
      "x-ms-enum": {
        "name": "DominantPollutant",
        "modelAsString": true,
        "values": [
          {
            "name": "Carbon Monoxide",
            "value": "Carbon Monoxide",
            "description": "Carbon monoxide (**CO**) is a colorless, odorless, and tasteless but highly\ntoxic gas produced by the incomplete combustion of carbon-containing fuels.\nCommon sources include vehicle exhaust, gas stoves, furnaces, and wood\nfires."
          },
          {
            "name": "Nitrogen Dioxide",
            "value": "Nitrogen Dioxide",
            "description": "Nitrogen dioxide (**NO2**) is a significant atmospheric pollutant. It is\nregulated and subject to recommended limit guidelines set by the World\nHealth Organization (WHO)."
          },
          {
            "name": "Ozone",
            "value": "Ozone",
            "description": "Ozone (**O3**) is a key component of photochemical smog, the brown, harmful\nhaze that envelops many large cities, resulting from a photochemical\nreaction between sunlight and certain specific pollutants."
          },
          {
            "name": "Particulate Matter 2.5",
            "value": "Particulate Matter 2.5",
            "description": "Particulate matter 2.5 (**PM2.5**) refers to fine particles with diameters that\nare generally 2.5 micrometers and smaller. These particles are more than 100 times\nthinner than a human hair and can remain suspended in the air for extended periods."
          },
          {
            "name": "Particulate Matter 10",
            "value": "Particulate Matter 10",
            "description": "Particulate matter 10 (**PM10**) refers to particles with diameters that are generally 10\nmicrometers and smaller. These particles can include dust, pollen, soot, smoke, and liquid droplets."
          },
          {
            "name": "Sulfur Dioxide",
            "value": "Sulfur Dioxide",
            "description": "Sulfur dioxide (**SO2**) is a heavy, colorless inorganic gas with a pungent,\nirritating odor. It is mainly produced by burning fossil fuels at power\nplants and industrial facilities, but it can also be emitted from natural\nsources such as volcanoes."
          }
        ]
      }
    }
  }
}