空气质量每日预报(new)

平台: API

空气质量每日预报API提供未来3天的空气质量(AQI)预报、污染物浓度值和健康建议。

我们推荐阅读空气质量信息文档,以便了解AQI的类型、污染物、支持的国家等信息。

请求URL

https://api.qweather.com/airquality/v1/daily/{latitude}/{longitude}?{查询参数}

如果是免费订阅,将上述API Host更改为devapi.qweather.com。参考免费订阅可用的数据

路径参数

  • latitude(必选)所需位置的纬度。十进制,最多支持小数点后两位。例如 39.92
  • longitude(必选)所需位置的经度。十进制,最多支持小数点后两位。例如 116.41

查询参数

  • key(必选)用户认证key,请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC
  • lang多语言设置,请阅读多语言文档,了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。

请求示例

curl -L -X GET --compressed 'https://api.qweather.com/airquality/v1/daily/39.90/116.40?key=YOUR_KEY'

返回数据

返回数据是JSON格式并进行了Gzip压缩

{
  "metadata": {
    "tag": "4b78230843e636a6f910631d94878da73aa980a66abfcf53d35f9c06493a292d"
  },
  "days": [
    {
      "forecastStartTime": "2023-02-14T23:00Z",
      "forecastEndTime": "2023-02-15T23:00Z",
      "indexes": [
        {
          "code": "qaqi",
          "name": "QAQI",
          "aqi": 1.0,
          "aqiDisplay": "1.0",
          "level": "1",
          "category": "Excellent",
          "color": {
            "red": 195,
            "green": 217,
            "blue": 78,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "pm2p5",
            "name": "PM 2.5",
            "fullName": "Fine particulate matter (<2.5µm)"
          },
          "health": {
            "effect": "No health implications.",
            "advice": {
              "generalPopulation": "Enjoy your outdoor activities.",
              "sensitivePopulation": "Enjoy your outdoor activities."
            }
          }
        },
        {
          "code": "eu-eea",
          "name": "EAQI (EU)",
          "aqi": 2,
          "aqiDisplay": "2",
          "level": "2",
          "category": "Fair",
          "color": {
            "red": 80,
            "green": 204,
            "blue": 170,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "pm2p5",
            "name": "PM 2.5",
            "fullName": "Fine particulate matter (<2.5µm)"
          },
          "health": {
            "effect": null,
            "advice": {
              "generalPopulation": "Enjoy your usual outdoor activities.",
              "sensitivePopulation": "Enjoy your usual outdoor activities."
            }
          }
        }
      ],
      "pollutants": [
        {
          "code": "pm2p5",
          "name": "PM 2.5",
          "fullName": "Fine particulate matter (<2.5µm)",
          "concentration": {
            "value": 11.88,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 2,
              "aqiDisplay": "2"
            },
            {
              "code": "qaqi",
              "aqi": 1,
              "aqiDisplay": "1"
            }
          ]
        },
        {
          "code": "pm10",
          "name": "PM 10",
          "fullName": "Inhalable particulate matter (<10µm)",
          "concentration": {
            "value": 2.38,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "no2",
          "name": "NO2",
          "fullName": "Nitrogen dioxide",
          "concentration": {
            "value": 4.1,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "o3",
          "name": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 36.33,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.8,
              "aqiDisplay": "0.8"
            }
          ]
        },
        {
          "code": "so2",
          "name": "SO2",
          "fullName": "Sulfur dioxide",
          "concentration": {
            "value": 32.13,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.7,
              "aqiDisplay": "0.7"
            }
          ]
        }
      ]
    },
    {
      "forecastStartTime": "2023-02-15T23:00Z",
      "forecastEndTime": "2023-02-16T23:00Z",
      "indexes": [
        {
          "code": "qaqi",
          "name": "QAQI",
          "aqi": 1.1,
          "aqiDisplay": "1.1",
          "level": "1",
          "category": "Excellent",
          "color": {
            "red": 195,
            "green": 217,
            "blue": 78,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "o3",
            "name": "O3",
            "fullName": "Ozone"
          },
          "health": {
            "effect": "No health implications.",
            "advice": {
              "generalPopulation": "Enjoy your outdoor activities.",
              "sensitivePopulation": "Enjoy your outdoor activities."
            }
          }
        },
        {
          "code": "eu-eea",
          "name": "EAQI (EU)",
          "aqi": 2,
          "aqiDisplay": "2",
          "level": "2",
          "category": "Fair",
          "color": {
            "red": 80,
            "green": 204,
            "blue": 170,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "o3",
            "name": "O3",
            "fullName": "Ozone"
          },
          "health": {
            "effect": null,
            "advice": {
              "generalPopulation": "Enjoy your usual outdoor activities.",
              "sensitivePopulation": "Enjoy your usual outdoor activities."
            }
          }
        }
      ],
      "pollutants": [
        {
          "code": "pm2p5",
          "name": "PM 2.5",
          "fullName": "Fine particulate matter (<2.5µm)",
          "concentration": {
            "value": 9.13,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.8,
              "aqiDisplay": "0.8"
            }
          ]
        },
        {
          "code": "pm10",
          "name": "PM 10",
          "fullName": "Inhalable particulate matter (<10µm)",
          "concentration": {
            "value": 1.08,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "no2",
          "name": "NO2",
          "fullName": "Nitrogen dioxide",
          "concentration": {
            "value": 2.34,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "o3",
          "name": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 53.33,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 2,
              "aqiDisplay": "2"
            },
            {
              "code": "qaqi",
              "aqi": 1.1,
              "aqiDisplay": "1.1"
            }
          ]
        },
        {
          "code": "so2",
          "name": "SO2",
          "fullName": "Sulfur dioxide",
          "concentration": {
            "value": 22.17,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.5,
              "aqiDisplay": "0.5"
            }
          ]
        }
      ]
    },
    {
      "forecastStartTime": "2023-02-16T23:00Z",
      "forecastEndTime": "2023-02-17T23:00Z",
      "indexes": [
        {
          "code": "qaqi",
          "name": "QAQI",
          "aqi": 0.9,
          "aqiDisplay": "0.9",
          "level": "1",
          "category": "Excellent",
          "color": {
            "red": 195,
            "green": 217,
            "blue": 78,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "o3",
            "name": "O3",
            "fullName": "Ozone"
          },
          "health": {
            "effect": "No health implications.",
            "advice": {
              "generalPopulation": "Enjoy your outdoor activities.",
              "sensitivePopulation": "Enjoy your outdoor activities."
            }
          }
        },
        {
          "code": "eu-eea",
          "name": "EAQI (EU)",
          "aqi": 1,
          "aqiDisplay": "1",
          "level": "1",
          "category": "Good",
          "color": {
            "red": 80,
            "green": 240,
            "blue": 230,
            "alpha": 1
          },
          "primaryPollutant": {
            "code": "o3",
            "name": "O3",
            "fullName": "Ozone"
          },
          "health": {
            "effect": null,
            "advice": {
              "generalPopulation": "The air quality is good. Enjoy your usual outdoor activities.",
              "sensitivePopulation": "The air quality is good. Enjoy your usual outdoor activities."
            }
          }
        }
      ],
      "pollutants": [
        {
          "code": "pm2p5",
          "name": "PM 2.5",
          "fullName": "Fine particulate matter (<2.5µm)",
          "concentration": {
            "value": 8.5,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.7,
              "aqiDisplay": "0.7"
            }
          ]
        },
        {
          "code": "pm10",
          "name": "PM 10",
          "fullName": "Inhalable particulate matter (<10µm)",
          "concentration": {
            "value": 1.54,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "no2",
          "name": "NO2",
          "fullName": "Nitrogen dioxide",
          "concentration": {
            "value": 2.77,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.1,
              "aqiDisplay": "0.1"
            }
          ]
        },
        {
          "code": "o3",
          "name": "O3",
          "fullName": "Ozone",
          "concentration": {
            "value": 43.86,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.9,
              "aqiDisplay": "0.9"
            }
          ]
        },
        {
          "code": "so2",
          "name": "SO2",
          "fullName": "Sulfur dioxide",
          "concentration": {
            "value": 20.94,
            "unit": "μg/m3"
          },
          "subIndexes": [
            {
              "code": "eu-eea",
              "aqi": 1,
              "aqiDisplay": "1"
            },
            {
              "code": "qaqi",
              "aqi": 0.5,
              "aqiDisplay": "0.5"
            }
          ]
        }
      ]
    }
  ]
}
  • metadata.tag 数据标签
  • days.forecastStartTime 预报数据的开始时间,ISO8601格式
  • days.forecastEndTime 预报数据的结束时间,ISO8601格式
  • days.indexes.code 空气质量指数Code
  • days.indexes.name 空气质量指数的名字
  • days.indexes.aqi 空气质量指数的值
  • days.indexes.aqiDisplay 空气质量指数的值的文本显示
  • days.indexes.level 空气质量指数等级,可能为空
  • days.indexes.category 空气质量指数类别,可能为空
  • days.indexes.color.red 空气质量指数的颜色,RGBA中的red
  • days.indexes.color.green 空气质量指数的颜色,RGBA中的green
  • days.indexes.color.blue 空气质量指数的颜色,RGBA中的blue
  • days.indexes.color.alpha 空气质量指数的颜色,RGBA中的alpah
  • days.indexes.primaryPollutant.code 首要污染物的Code,可能为空
  • days.indexes.primaryPollutant.name 首要污染物的名字,可能为空
  • days.indexes.primaryPollutant.fullName 首要污染物的全称,可能为空
  • days.indexes.health.effect 空气质量对健康的影响,可能为空
  • days.indexes.health.advice.generalPopulation 对一般人群的健康指导意见,可能为空
  • days.indexes.health.advice.sensitivePopulation 对敏感人群的健康指导意见,可能为空
  • days.pollutants.code 污染物的Code
  • days.pollutants.name 污染物的名字
  • days.pollutants.fullName 污染物的全称
  • days.pollutants.concentration.value 污染物的浓度值
  • days.pollutants.concentration.unit 污染物的浓度值的单位
  • days.pollutants.subIndexes.code 污染物的分指数的Code,可能为空
  • days.pollutants.subIndexes.aqi 污染物的分指数的数值,可能为空
  • days.pollutants.subIndexes.aqiDisplay 污染物的分指数数值的显示名称