--- title: "Use to get current air quality information that includes potential risks and suggested precautions." method: GET path: "/weather/airQuality/current/{format}" --- # Use to get current air quality information that includes potential risks and suggested precautions. `GET /weather/airQuality/current/{format}` The `Get Current Air Quality` API is an HTTP `GET` request that returns detailed information about the concentration of pollutants and overall status for current air quality, including pollution levels, air quality index values, the dominant pollutant, and a brief statement summarizing risk level and suggested precautions. ## Path parameters - `format` 'json', required ## Query parameters - `api-version` string, required - `language` string - `query` number[], required - `pollutants` boolean ## Headers - `x-ms-client-id` string ## Response `200` The request has succeeded. - AirQualityResult — An array of [AirQuality](#airquality) objects, each providing comprehensive information about the current air quality at the specified location. - `results` AirQuality[] — Detailed air quality results within the specified location, including properties such as the air quality index (AQI), dominant pollutant, pollutant levels, risk level, and suggested precautions. - `dateTime` string, date-time — Date and time of the current observation, displayed in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, *2025-04-29T07:00:00-07:00*. - `index` number, float — The air quality index (AQI) is an air quality rating scale set by local regulating bodies. Scales can vary widely based on location. For more information, see [Air quality index](https://en.wikipedia.org/wiki/Air_quality_index) in Wikipedia. - `globalIndex` number, float — Represents a normalized global air quality index aligned with international scientific standards, including World Health Organization (WHO) guidelines and U.S. EPA AQI definitions. The value reflects overall air quality based on measured pollutant concentrations, where the pollutant posing the greatest potential health impact determines the final index value. The returned value uses an AQI-style range from 0 to 250+ and maps to defined air quality categories. The dominant pollutant is the pollutant with the highest individual index value. For example, if pollutant index values are: The resulting globalIndex value is 50, and the dominant pollutant is NO₂. Air quality categories associated with the index value are: - `dominantPollutant` 'Carbon Monoxide' | 'Nitrogen Dioxide' | 'Ozone' | 'Particulate Matter 2.5' | 'Particulate Matter 10' | 'Sulfur Dioxide' — Identifies the pollutant with the highest concentration. - `category` string — Provides a one-word description of the air quality for the forecast period in the specified language, such as Poor, Fair, or Excellent. - `categoryColor` string — Provides a unique hexadecimal color code corresponding to the air quality category for each day in the forecast period. This color helps users quickly identify the air quality level visually, with each color corresponding to a category such as Poor, Fair, or Excellent. - `description` string — A textual explanation of this air quality result in the requested language. - `pollutants` Pollutant[] — An array containing detailed information about each pollutant in the response. Returned when the `pollutants` URI Parameter is *true*. - `type` 'CO' | 'NO2' | 'O3' | 'PM2.5' | 'PM10' | 'SO2' — Specifies the six types of pollutants tracked by the Azure Maps Weather service. - `name` string — The name of the pollutant in English. - `index` number, float — Air quality rating on a scale set by local regulating bodies. Scales can vary widely based on location. See [Wikipedia](https://en.wikipedia.org/wiki/Air_quality_index) for more information. - `globalIndex` number, float — Represents a normalized global air quality index aligned with international scientific standards, including World Health Organization (WHO) guidelines and U.S. EPA AQI definitions. The value reflects overall air quality based on measured pollutant concentrations, where the pollutant posing the greatest potential health impact determines the final index value. The returned value uses an AQI-style range from 0 to 250+ and maps to defined air quality categories. The dominant pollutant is the pollutant with the highest individual index value. For example, if pollutant index values are: The resulting globalIndex value is 50, and the dominant pollutant is NO₂. Air quality categories associated with the index value are: - `concentration` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `nextLink` string — Contains the URL to fetch the next page of results if the response is paginated. This is useful when the response is too large to be returned in a single call, allowing users to navigate through multiple pages of results. ## Other responses - `default` — An unexpected error response. --- [API](https://skmtc.net/azure/apis/maps-weather.md) · [All operations](https://skmtc.net/azure/apis/maps-weather/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/maps-weather/versions/3c076fdd2918/schema)