涨知识！一文带你读懂空气质量数据（附Java 和小程序接入示例代码）

空气污染对人类健康和环境造成了巨大的危害。据统计，每年因空气污染导致的早逝人数超过数百万人。长期暴露在污染物中，人们易患呼吸系统疾病、心血管疾病、癌症等。此外，空气污染还对生态系统、农作物和能源消耗产生负面影响。

在解决空气质量问题的过程中，空气质量查询 API 发挥着重要的作用，并带来了巨大的价值。它提供了实时、准确的数据，为决策者提供了依据，并通过其便捷性和可定制性为公众带来了便利。通过 API 的应用，我们能够更好地监测、分析和改善空气质量，为我们的社会和环境带来更健康、可持续的未来。

空气质量查询 API 简介

空气质量查询 API 支持国内3400+个城市的整点观测，并附带空气质量监测点（全国共2335个）的整点观测数据，并且支持国内经纬度查询，返回最近的站点信息。

获取到的数据包含空气质量指数（AQI）、首要污染物、空气质量等级（优、良、轻度污染、中度污染、重度污染、严重污染）、6要素（CO、NO₂、O₃、PM10、PM2.5、SO₂）浓度（除了CO浓度单位为mg/m³之外，其余5种单位均为μg/m³）等。

API 接入代码

为大家总结了Java、以及微信小程序代码中的 X-APISpace-Token 可以在 APISpace 登录注册获取，希望对大家有所帮助。

Java 版

OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
Request request = new Request.Builder()
  .url("https://eolink.o.apispace.com/34324/air/v001/aqi?areacode=101010100&lonlat=116.407526,39.904030")
  .method("GET",null)
  .addHeader("X-APISpace-Token","") // 使用 APISpace 提供的API 密钥
  .addHeader("Authorization-Type","apikey")
  .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

微信小程序

var data = "" 

wx.request({
    "url":"https://eolink.o.apispace.com/34324/air/v001/aqi?areacode=101010100&lonlat=116.407526,39.904030",
    "method": "GET",
    "header": {
        "X-APISpace-Token":"", // 使用 APISpace 提供的API 密钥
        "Authorization-Type":"apikey"
    },
    "data": data,
    "success": (response)=> {
        console.log(response.data)
    }
})

API 数据返回格式及参数解释

返回格式

{
    “status”: 0,
    “result”: {
        “location”: {
            “areacode”: “101010100”,    //城市ID
            “name”: “北京”,        //城市中文名
            “country”: “中国”,        //所属国家中文名
            “path”: “北京,北京市,北京市,中国”    //行政区划路径
        },
        “realtimeAqi”: {
            “aqi”: 124,            //空气质量指数
            “aqi_level”: “轻度污染”,    //空气质量等级
            “pm10”: 59,        //PM10浓度，单位: 微克/立方米
            “pm25”: 94,        //PM2.5浓度，单位: 微克/立方米
            “no2”: 18,            //二氧化氮浓度，单位: 微克/立方米
            “so2”: 3,            //二氧化硫浓度，单位: 微克/立方米
            “co”: 1.0,            //一氧化碳浓度，单位: 毫克/立方米
            “o3”: 36,            //臭氧浓度，单位: 微克/立方米
            “pollutant”: “一氧化碳”,    //首要污染物，有时为空
            “data_time”: “2020-02-14 09:00:00”,    //实况数据时间
            “stations”: [
                {
                    “stationID”: “1011A”,    //站点编号
                    “lon”: 116.73,        //站点经度
                    “lat”: 39.68,        //站点纬度
                    “name”: “永定门”,        //站点名称
                    “aqi”: 68,            //实时空气质量指数
                    “aqi_level”: “良”,        //空气质量等级
                    “pm10”: 0,            //PM10浓度，单位: 微克/立方米
                    “pm25”: 49,        //PM2.5浓度，单位: 微克/立方米
                    “no2”: 27,            //二氧化氮浓度，单位: 微克/立方米
                    “so2”: 2,            //二氧化硫浓度，单位: 微克/立方米
                    “co”: 1.0,            //一氧化碳浓度，单位: 毫克/立方米
                    “o3”: 30,            //臭氧浓度，单位: 微克/立方米
                    “pollutant”: “细颗粒物(PM2.5)”,    //首要污染物，有时为空
                },
                ……                //其它站点实况信息
            ]
        }
        “last_update”: “2020-02-14 09:44:00”,    //数据更新时间
    }
}

参数解释

1. 空气质量指数（AQI）的解释和使用

空气质量指数（Air Quality Index，AQI）是衡量空气质量状况的重要指标。它通过对不同污染物浓度的测量，将空气质量综合表示为一个数值，使人们更直观地了解当前空气质量的好坏程度。

AQI的计算方式

AQI的计算方式根据不同国家和地区可能有所不同，但通常是基于各项污染物浓度的测量结果，采用特定的公式来计算得出。不同污染物的浓度会被赋予不同的权重，以反映其对空气质量的影响程度。

例如，常见的污染物包括二氧化硫（SO₂）、氮氧化物（NO₂）、臭氧（O₃）、颗粒物（PM10和PM2.5）等。

以下是一个示例的AQI计算公式：

涨知识！一文带你读懂空气质量数据（附Java 和小程序接入示例代码）

AQI 数据解读

不同范围内的AQI等级及其含义可以大致描述如下：
- 优（0-50）：空气质量非常好，对健康影响极小。
- 良（51-100）：空气质量良好，一般情况下对健康无明显影响。
- 轻度污染（101-150）：可能对敏感人群的健康产生一定影响。
- 中度污染（151-200）：可能对大部分人群的健康产生不良影响。
- 重度污染（201-300）：可能对所有人群的健康产生严重影响。
- 严重污染（301-500）：空气质量极差，对所有人群的健康产生严重危害。

2. 首要污染物及其重要性

首要污染物是指对空气质量影响最为显著的污染物。它们通常是由人类活动引起的，具有高浓度和广泛分布的特点，对空气质量和人类健康产生重要影响。

首要污染物种类

常见的首要污染物包括但不限于以下几种：
- 二氧化硫（SO₂） ：主要来自燃煤、石油燃烧和工业生产过程中的硫化物排放，可以导致呼吸系统问题，加剧哮喘和慢性支气管炎等疾病。
- 氮氧化物（NOx） ：主要来自燃煤、汽车尾气以及工业和农业活动中氮化物的排放，可造成呼吸道炎症和损害肺功能，对患有哮喘和慢性阻塞性肺病的人更具危害。
- 臭氧（O₃） ：是光化学反应产生的，主要源于汽车尾气和工业排放物中的氮氧化物和挥发性有机化合物，对呼吸系统和眼睛有刺激作用，引起咳嗽、胸闷和眼痛等症状。
- 颗粒物（PM10和PM2.5） ：来自燃煤、机动车尾气、工业排放、扬尘和天然源等，能够进入呼吸道并沉积在肺部，导致呼吸道炎症、心血管问题和肺癌等。
- 一氧化碳（CO） ：主要来自燃煤、汽车尾气和工业排放，可与血红蛋白结合，降低血液输送氧气的能力，对心脏病患者和孕妇尤为危险。

3. 空气质量等级及其含义

空气质量等级通常根据空气污染物的浓度和对人体健康的影响程度进行划分。不同国家和地区可能采用不同的标准，但一般会参考国际上公认的空气质量指数（AQI）标准和污染物浓度限值。

各等级的空气质量特征和影响

空气质量等级通常分为以下几个等级：优、良、轻度污染、中度污染、重度污染和严重污染，通常采用颜色表示。
- 优（绿色）：空气质量极好，对健康几乎没有影响，污染物浓度很低。
- 良（黄色）：空气质量良好，对大多数人无害，但对极少数特别敏感的人群可能产生轻微影响。
- 轻度污染（橙色）：空气质量一般，可能对敏感人群产生不适，一般公众则影响较小。
- 中度污染（红色）：空气质量较差，对所有人都可能产生不适的影响，敏感人群可能出现更明显的症状。
- 重度污染（紫色）：空气质量很差，对所有人都可能产生明显的健康影响，敏感人群可能出现严重症状。
- 严重污染（褐红色）：空气质量极差，对所有人都可能产生严重的健康影响，甚至危及生命。