前言

各类生活服务、出行类应用在开发过程中，往往需要接入城市实时空气质量数据。自行对接多渠道环境数据源，需要处理数据同步、格式归一、定时更新等一系列工作，开发维护成本较高。空气质量查询接口可获取国内城市实时环境监测数据，快速为业务注入空气质量实况能力。

核心能力

• 覆盖国内数百座城市，提供实时空气质量监测数据；
• 提供多维度空气质量查询：查询全国370个城市空气质量、按全国城市空气质量排行查询、PM数按IP查询、PM数据按城市查询；
• 包含多项污染物浓度指标：AQI 空气质量指数、空气质量等级、首要污染物，以及 PM2.5、PM10、二氧化硫、二氧化氮、臭氧、一氧化碳等；
• 每半小时更新全国最多367个城市空气质量。

戳这里查看详情

空气质量-全国城市空气质量查询

根据城市查询对应的空气质量。由于国家只发布了370个大城市空气质量，因此查询小地区返回上一级主要城市的PM25情况。

请求说明

返回样例

{
  "code": 200,//返回码，详见返回码说明
  "msg": "成功",//返回码对应描述
  "taskNo": "325946705208507560688788",//本次请求号
  "charge": true,//计费标志
  "data": {
    "area": "杭州",//地区名
    "o3": "22",//臭氧1小时平均，μg/m³
    "area_code": "hangzhou",
    "num": "153",//排行
    "pm10": "63",//颗粒物（粒径小于等于10μm）1小时平均，μg/m³
    "co": "0.9",//一氧化碳1小时平均，mg/m³
    "quality": "良好",//空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类
    "no2": "61",//二氧化氮1小时平均，μg/m³
    "ct": "2024-11-02 23:10:00.012",//发布时间
    "so2": "6",//二氧化硫一小时平均，μg/m³
    "pm2_5": "34",//颗粒物（粒径小于等于2.5μm）1小时平均，μg/m³
    "aqi": "57",//空气质量指数(AQI)，即air quality index，是定量描述空气质量状况的无纲量指数
    "primary_pollutant": "颗粒物(PM10)",//首要污染物
    "o3_8h": "79"//臭氧8小时滑动平均，μg/m³
  }
}

空气质量-全国城市空气质量排行榜

查询全国367个城市的空气质量排行榜。

返回样例

{
  "code": 200,//返回码，详见返回码说明
  "msg": "成功",//返回码对应描述
  "taskNo": "823469219158756173215449",//本次请求号
  "charge": true,//计费标志
  "data": {
    "list": [
      {
        "area": "昌都",//地区名
        "o3": "30",//臭氧1小时平均，μg/m³
        "area_code": "changdou",
        "num": "1",//排行
        "pm10": "15",//颗粒物（粒径小于等于10μm）1小时平均，μg/m³
        "co": "0.6",//一氧化碳1小时平均，mg/m³
        "quality": "优质",//空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类
        "no2": "12",//二氧化氮1小时平均，μg/m³
        "ct": "2024-11-03 09:40:00.011",//发布时间
        "so2": "6",//二氧化硫一小时平均，μg/m³
        "pm2_5": "9",//颗粒物（粒径小于等于2.5μm）1小时平均，μg/m³
        "aqi": "15",//空气质量指数(AQI)，即air quality index，是定量描述空气质量状况的无纲量指数
        "primary_pollutant": "",//首要污染物
        "o3_8h": "30"//臭氧8小时滑动平均，μg/m³
      },
      ......
    ]
  }
}

空气质量-PM数据-按城市查询

查询单个城市及其下属的监测点的PM数据，包括AQI，空气质量，指数类别，首要污染物，PM 2.5，细颗粒物，PM 10，可吸入颗粒物， 一氧化碳， 二氧化氮， 臭氧1小时平均， 臭氧8小时平均， 二氧化硫等信息。每8小时更新367个城市下各个监测点相关详细PM数据。

请求说明

返回样例

{
  "code": 200,//返回码，详见返回码说明
  "msg": "成功",//返回码对应描述
  "taskNo": "518352325189267867664895",//本次请求号
  "charge": true,//计费标志
  "data": {
    "pm": { //PM结构数据
      "area": "杭州",//城市名称
      "o3": "24",//臭氧1小时平均，μg/m³
      "area_code": "hangzhou",
      "num": "93",//排行
      "pm10": "46",//颗粒物（粒径小于等于10μm）1小时平均，μg/m³
      "co": "0.7",//一氧化碳1小时平均，mg/m³
      "quality": "优质",//空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类
      "no2": "38",//二氧化氮1小时平均，μg/m³
      "ct": "2024-11-03 09:40:00.011",//发布时间
      "so2": "6",//二氧化硫一小时平均，μg/m³
      "pm2_5": "31",//颗粒物（粒径小于等于2.5μm）1小时平均，μg/m³
      "aqi": "42",//空气质量指数(AQI)，即air quality index，是定量描述空气质量状况的无纲量指数
      "primary_pollutant": "",//首要污染物
      "o3_8h": "11" //臭氧8小时滑动平均，μg/m³
    },
    "siteList": [ //下属的监测站的PM数据。此列表数据只在【单个城市PM】接入点中存在。
      {
        "no2": "7", //二氧化氮1小时平均，μg/m³
        "site_name": "市府大楼", //监测点名称
        "ct": "2022-07-06 11:39:00.707",//发布时间
        "o3": "59",//臭氧1小时平均，μg/m³
        "so2": "9", //二氧化硫一小时平均，μg/m³
        "pm2_5": "7",//颗粒物（粒径小于等于2.5μm）1小时平均，μg/m³
        "aqi": "19",//空气质量指数(AQI)，即air quality index，是定量描述空气质量状况的无纲量指数
        "pm10": "17", //颗粒物（粒径小于等于10μm）1小时平均，μg/m³
        "primary_pollutant": "-",//首要污染物
        "co": "0.6",//一氧化碳1小时平均，mg/m³
        "quality": "优质", //空气质量指数类别，有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
        "o3_8h": "59" //臭氧8小时滑动平均，μg/m³
      },
      ......
    ]
  }
}

空气质量-PM数据-按IP查询

根据ip查询单个城市及其下属的监测点的PM数据，包括AQI，空气质量，指数类别，首要污染物，PM 2.5，细颗粒物，PM 10，可吸入颗粒物， 一氧化碳， 二氧化氮， 臭氧1小时平均， 臭氧8小时平均， 二氧化硫等信息。每8小时更新367个城市下各个监测点相关详细PM数据。

请求说明

返回样例

{
  "code": 200,//返回码，详见返回码说明
  "msg": "成功",//返回码对应描述
  "taskNo": "569922565184110844672479",//本次请求号
  "charge": true,//计费标志
  "data": {
    "pm": { //PM结构数据
      "area": "杭州",//城市名称
      "o3": "24",//臭氧1小时平均，μg/m³
      "area_code": "hangzhou",
      "num": "93",//排行
      "pm10": "46",//颗粒物（粒径小于等于10μm）1小时平均，μg/m³
      "co": "0.7",//一氧化碳1小时平均，mg/m³
      "quality": "优质",//空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类
      "no2": "38",//二氧化氮1小时平均，μg/m³
      "ct": "2024-11-03 09:40:00.011",//发布时间
      "so2": "6",//二氧化硫一小时平均，μg/m³
      "pm2_5": "31",//颗粒物（粒径小于等于2.5μm）1小时平均，μg/m³
      "aqi": "42",//空气质量指数(AQI)，即air quality index，是定量描述空气质量状况的无纲量指数
      "primary_pollutant": "",//首要污染物
      "o3_8h": "11" //臭氧8小时滑动平均，μg/m³
    },
    "siteList": [ //下属的监测站的PM数据。此列表数据只在【单个城市PM】接入点中存在。
      {
        "no2": "7", //二氧化氮1小时平均，μg/m³
        "site_name": "市府大楼", //监测点名称
        "ct": "2022-07-06 11:39:00.707",//发布时间
        "o3": "59",//臭氧1小时平均，μg/m³
        "so2": "9", //二氧化硫一小时平均，μg/m³
        "pm2_5": "7",//颗粒物（粒径小于等于2.5μm）1小时平均，μg/m³
        "aqi": "19",//空气质量指数(AQI)，即air quality index，是定量描述空气质量状况的无纲量指数
        "pm10": "17", //颗粒物（粒径小于等于10μm）1小时平均，μg/m³
        "primary_pollutant": "-",//首要污染物
        "co": "0.6",//一氧化碳1小时平均，mg/m³
        "quality": "优质", //空气质量指数类别，有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
        "o3_8h": "59" //臭氧8小时滑动平均，μg/m³
      },
      ......
    ]
  }
}