{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-maps/json-schema/google-maps-lookup-forecast-response-schema.json",
  "title": "LookupForecastResponse",
  "description": "The response object of the air quality forecast API.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-maps-airquality-forecast-api-openapi.yml#/components/schemas/LookupForecastResponse",
  "type": "object",
  "properties": {
    "nextPageToken": {
      "type": "string",
      "description": "Optional. The token to retrieve the next page."
    },
    "hourlyForecasts": {
      "type": "array",
      "description": "Optional. Contains the air quality information for each hour in the requested range. For example, if the request is for 48 hours of forecast there will be 48 elements of hourly forecasts.",
      "items": {
        "$ref": "#/$defs/HourlyForecast"
      }
    },
    "regionCode": {
      "description": "Optional. The ISO_3166-1 alpha-2 code of the country/region corresponding to the location provided in the request. This field might be omitted from the response if the location provided in the request resides in a disputed territory.",
      "type": "string"
    }
  },
  "$defs": {
    "AdditionalInfo": {
      "type": "object",
      "properties": {
        "sources": {
          "type": "string",
          "description": "Text representing the pollutant's main emission sources."
        },
        "effects": {
          "description": "Text representing the pollutant's main health effects.",
          "type": "string"
        }
      },
      "description": "The emission sources and health effects of a given pollutant."
    },
    "AirQualityIndex": {
      "type": "object",
      "description": "The basic object for representing different air quality metrics. When brought together, these metrics provide a snapshot about the current air quality conditions. There are multiple indexes in the world serving different purposes and groups interested in measuring different aspects of air quality.",
      "properties": {
        "code": {
          "description": "The index's code. This field represents the index for programming purposes by using snake case instead of spaces. Examples: \"uaqi\", \"fra_atmo\".",
          "type": "string"
        },
        "aqiDisplay": {
          "description": "Textual representation of the index numeric score, that may include prefix or suffix symbols, which usually represents the worst index score. Example: >100 or 10+. Note: This field should be used when you want to display the index score. For non-numeric indexes, this field is empty.",
          "type": "string"
        },
        "aqi": {
          "format": "int32",
          "description": " The index's numeric score. Examples: 10, 100. The value is not normalized and should only be interpreted in the context of its related air-quality index. For non-numeric indexes, this field will not be returned. Note: This field should be used for calculations, graph display, etc. For displaying the index score, you should use the AQI display field.",
          "type": "integer"
        },
        "dominantPollutant": {
          "type": "string",
          "description": "The chemical symbol of the dominant pollutant. For example: \"CO\"."
        },
        "displayName": {
          "type": "string",
          "description": "A human readable representation of the index name. Example: \"AQI (US)\""
        },
        "category": {
          "description": "Textual classification of the index numeric score interpretation. For example: \"Excellent air quality\".",
          "type": "string"
        },
        "color": {
          "$ref": "#/$defs/Color",
          "description": "The color used to represent the AQI numeric score."
        }
      }
    },
    "Color": {
      "properties": {
        "alpha": {
          "format": "float",
          "type": "number",
          "description": "The fraction of this color that should be applied to the pixel. That is, the final pixel color is defined by the equation: `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)` This means that a value of 1.0 corresponds to a solid color, whereas a value of 0.0 corresponds to a completely transparent color. This uses a wrapper message rather than a simple float scalar so that it is possible to distinguish between a default value and the value being unset. If omitted, this color object is rendered as a solid color (as if the alpha value had been explicitly given a value of 1.0)."
        },
        "red": {
          "type": "number",
          "description": "The amount of red in the color as a value in the interval [0, 1].",
          "format": "float"
        },
        "green": {
          "description": "The amount of green in the color as a value in the interval [0, 1].",
          "type": "number",
          "format": "float"
        },
        "blue": {
          "format": "float",
          "description": "The amount of blue in the color as a value in the interval [0, 1].",
          "type": "number"
        }
      },
      "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha <= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red << 16) | (green << 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i < missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...",
      "type": "object"
    },
    "Concentration": {
      "properties": {
        "units": {
          "enum": [
            "UNIT_UNSPECIFIED",
            "PARTS_PER_BILLION",
            "MICROGRAMS_PER_CUBIC_METER"
          ],
          "type": "string",
          "description": "Units for measuring this pollutant concentration."
        },
        "value": {
          "description": "Value of the pollutant concentration.",
          "type": "number",
          "format": "float"
        }
      },
      "type": "object",
      "description": "The concentration of a given pollutant in the air."
    },
    "HealthRecommendations": {
      "properties": {
        "lungDiseasePopulation": {
          "type": "string",
          "description": "Respiratory related problems and asthma suffers."
        },
        "pregnantWomen": {
          "description": "Women at all stages of pregnancy.",
          "type": "string"
        },
        "heartDiseasePopulation": {
          "description": "Heart and circulatory system diseases.",
          "type": "string"
        },
        "athletes": {
          "description": "Sports and other strenuous outdoor activities.",
          "type": "string"
        },
        "elderly": {
          "description": "Retirees and people older than the general population.",
          "type": "string"
        },
        "children": {
          "description": "Younger populations including children, toddlers, and babies.",
          "type": "string"
        },
        "generalPopulation": {
          "description": "No specific sensitivities.",
          "type": "string"
        }
      },
      "type": "object",
      "description": "Health recommendations for different population groups in a free text format. The recommendations are derived from their associated air quality conditions."
    },
    "HourlyForecast": {
      "description": "Contains the air quality information for each hour in the requested range. For example, if the request is for 48 hours of forecast there will be 48 elements of hourly forecasts.",
      "type": "object",
      "properties": {
        "healthRecommendations": {
          "$ref": "#/$defs/HealthRecommendations",
          "description": "Health advice and recommended actions related to the reported air quality conditions. Recommendations are tailored differently for populations at risk, groups with greater sensitivities to pollutants, and the general population."
        },
        "dateTime": {
          "description": "A rounded down timestamp indicating the time (hour) the data refers to in RFC3339 UTC \"Zulu\" format. For example: \"2014-10-02T15:00:00Z\".",
          "format": "google-datetime",
          "type": "string"
        },
        "indexes": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/AirQualityIndex"
          },
          "description": "Based on the request parameters, this list will include (up to) two air quality indexes: - Universal AQI. Will be returned if the `universal_aqi` boolean is set to true. - Local AQI. Will be returned if the LOCAL_AQI extra computation is specified."
        },
        "pollutants": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Pollutant"
          },
          "description": "A list of pollutants affecting the location specified in the request. Note: This field will be returned only for requests that specified one or more of the following extra computations: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION."
        }
      }
    },
    "Pollutant": {
      "type": "object",
      "properties": {
        "concentration": {
          "$ref": "#/$defs/Concentration",
          "description": "The pollutant's concentration level measured by one of the standard air pollutation measure units."
        },
        "displayName": {
          "type": "string",
          "description": "The pollutant's display name. For example: \"NOx\"."
        },
        "fullName": {
          "type": "string",
          "description": "The pollutant's full name. For chemical compounds, this is the IUPAC name. Example: \"Sulfur Dioxide\". For more information about the IUPAC names table, see https://iupac.org/what-we-do/periodic-table-of-elements/."
        },
        "additionalInfo": {
          "$ref": "#/$defs/AdditionalInfo",
          "description": "Additional information about the pollutant."
        },
        "code": {
          "type": "string",
          "description": "The pollutant's code name (for example, \"so2\"). For a list of supported pollutant codes, see [Reported pollutants](/maps/documentation/air-quality/pollutants#reported_pollutants)."
        }
      },
      "description": "Data regarding an air quality pollutant."
    }
  }
}