实时空气质量

实时空气质量API提供全球指定地点的实时空气质量数据，精度为1x1公里，数据包括：

基于各个国家或地区当地标准的AQI、AQI等级、颜色和首要污染物
和风天气通用AQI
污染物浓度值、分指数
健康建议

请求路径#

GET /airquality/v1/current/{latitude}/{longitude}

参数#

路径参数

latitude^必选

number

所需位置的纬度。十进制，最多支持小数点后两位。例如 39.92
longitude^必选

number

所需位置的经度。十进制，最多支持小数点后两位。例如 116.41

查询参数

lang

string

多语言设置

请求示例#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/airquality/v1/current/39.92/116.41'

请将your_token替换为你的JWT身份认证，将your_api_host替换为你的API Host

试一下

返回数据#

{
  "metadata": {
    "tag": "d75a323239766b831889e8020cba5aca9b90fca5080a1175c3487fd8acb06e84",
    "attributions": [
      "https://developer.qweather.com/attribution.html"
    ]
  },
  "indexes": [
    {
      "code": "us-epa",
      "name": "AQI (US)",
      "aqi": 46,
      "aqiDisplay": "46",
      "level": "1",
      "category": "Good",
      "color": {
        "red": 0,
        "green": 228,
        "blue": 0,
        "alpha": 1
      },
      "primaryPollutant": {
        "code": "pm2p5",
        "name": "PM 2.5",
        "fullName": "Fine particulate matter (<2.5µm)"
      },
      "health": {
        "effect": "No health effects.",
        "advice": {
          "generalPopulation": "Everyone can continue their outdoor activities normally.",
          "sensitivePopulation": "Everyone can continue their outdoor activities normally."
        }
      }
    },
    {
      "code": "qaqi",
      "name": "QAQI",
      "aqi": 0.9,
      "aqiDisplay": "0.9",
      "level": "1",
      "category": "Excellent",
      "color": {
        "red": 80,
        "green": 240,
        "blue": 230,
        "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."
        }
      }
    }
  ],
  "pollutants": [
    {
      "code": "pm2p5",
      "name": "PM 2.5",
      "fullName": "Fine particulate matter (<2.5µm)",
      "concentration": {
        "value": 11.0,
        "unit": "μg/m3"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 46,
          "aqiDisplay": "46"
        },
        {
          "code": "qaqi",
          "aqi": 0.9,
          "aqiDisplay": "0.9"
        }
      ]
    },
    {
      "code": "pm10",
      "name": "PM 10",
      "fullName": "Inhalable particulate matter (<10µm)",
      "concentration": {
        "value": 12.0,
        "unit": "μg/m3"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 12,
          "aqiDisplay": "12"
        },
        {
          "code": "qaqi",
          "aqi": 0.5,
          "aqiDisplay": "0.5"
        }
      ]
    },
    {
      "code": "no2",
      "name": "NO2",
      "fullName": "Nitrogen dioxide",
      "concentration": {
        "value": 6.77,
        "unit": "ppb"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 7,
          "aqiDisplay": "7"
        },
        {
          "code": "qaqi",
          "aqi": 0.1,
          "aqiDisplay": "0.1"
        }
      ]
    },
    {
      "code": "o3",
      "name": "O3",
      "fullName": "Ozone",
      "concentration": {
        "value": 0.02,
        "unit": "ppb"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 21,
          "aqiDisplay": "21"
        },
        {
          "code": "qaqi",
          "aqi": 0.2,
          "aqiDisplay": "0.2"
        }
      ]
    },
    {
      "code": "co",
      "name": "CO",
      "fullName": "Carbon monoxide",
      "concentration": {
        "value": 0.25,
        "unit": "ppm"
      },
      "subIndexes": [
        {
          "code": "us-epa",
          "aqi": 3,
          "aqiDisplay": "3"
        },
        {
          "code": "qaqi",
          "aqi": 0.1,
          "aqiDisplay": "0.1"
        }
      ]
    }
  ],
  "stations": [
    {
      "id": "P51762",
      "name": "North Holywood"
    },
    {
      "id": "P58056",
      "name": "Pasadena"
    },
    {
      "id": "P57327",
      "name": "Los Angeles - N. Main Street"
    }
  ]
}

metadata

object

元数据
- tag
  
  string
  
  数据唯一标识
- attributions
  
  array
  
  数据归因信息或声明，必须与当前数据共同显示
indexes

array

空气质量指数列表，参考支持的空气质量指数
- code
  
  string
  
  空气质量指数的code
- name
  
  string
  
  空气质量指数的名字
- aqi
  
  number
  
  空气质量指数的数值，包括将非数字形式的指数值转换为数字后的结果，便于程序计算
- aqiDisplay
  
  string
  
  空气质量指数的标准显示值，可能包含非数字字符，向用户展示时建议使用该字段
- level
  
  string
  
  空气质量指数等级
- category
  
  string
  
  空气质量指数类别
- color
  
  object
  
  空气质量指数的 RGBA 颜色表示
  - red
    
    number
    
    红色分量值，取值范围 [0, 255]
  - green
    
    number
    
    绿色分量值，取值范围 [0, 255]
  - blue
    
    number
    
    蓝色分量值，取值范围 [0, 255]
  - alpha
    
    number
    
    透明度分量值，取值范围 [0, 1]
- primaryPollutant
  
  object
  
  首要污染物表示导致当前空气污染的主要成分
  - code
    
    string
    
    首要污染物的code
  - name
    
    string
    
    首要污染物的名字
  - fullName
    
    string
    
    首要污染物的全称
- health
  
  object
  
  空气质量对一般人群和敏感人群的健康影响及指导建议
  - effect
    
    string
    
    空气质量对健康的影响，可能为空
  - advice
    
    object
    
    健康建议，可能为空
    - generalPopulation
      
      string
      
      对一般人群的健康指导意见，可能为空
    - sensitivePopulation
      
      string
      
      对敏感人群的健康指导意见，可能为空
pollutants

array

污染物列表
- code
  
  string
  
  污染物code，可选值：pm10、pm2p5、co、no、no2、so2、o3、nmhc
- name
  
  string
  
  污染物的名字
- fullName
  
  string
  
  污染物的全称
- concentration
  
  object
  
  污染物的浓度值
  - value
    
    number
    
    数值
  - unit
    
    string
    
    单位
- subIndexes
  
  array
  
  各项污染物的空气质量分指数列表，通常最差的污染物分指数代表当前的空气质量指数，并用于确定首要污染物
  - code
    
    string
    
    分指数对应的空气质量指数代码
  - aqi
    
    number
    
    分指数的数值
  - aqiDisplay
    
    string
    
    分指数数值的显示名称