用 10 分钟为你的 App 接入空气质量数据API

前言

随着环境问题日益受到关注，空气质量数据已成为公众生活和决策的重要参考。空气质量查询API作为获取实时环境数据的技术接口，正被广泛应用于健康、城市规划、智能家居等领域。

空气质量API的核心功能

空气质量API通常提供以下关键数据指标：

• AQI（空气质量指数） ：综合评价空气质量的数值，分为优、良、轻度污染、中度污染、重度污染等等级。
• 主要污染物浓度：包括PM2.5、PM10、臭氧（O₃）、二氧化氮（NO₂）、二氧化硫（SO₂）、一氧化碳（CO）等。
• 数据来源与更新：支持实时数据、逐小时或历史数据查询，部分API还提供监测站点详细信息（如经纬度、站点名称等）。

空气质量查询API的技术实现与调用方式

这里我使用的是 APISpace 的 空气质量查询，它支持国内3400+个城市的整点观测，并附带空气质量监测点（全国共2335个）的整点观测数据。获取指定城市的整点观测空气质量，包含空气质量指数（AQI）、首要污染物、空气质量等级（优、良、轻度污染、中度污染、重度污染、严重污染）、6要素（CO、NO₂、O₃、PM10、PM2.5、SO₂）浓度（除了CO浓度单位为mg/m³之外，其余5种单位均为μg/m³） 等。

可查询空气质量实况、实施排行、昨日排行、过去24小时空气质量、逐小时空气质量、逐日空气质量。

示例调用方式：

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","API密钥，登录APISpace即可获得")
  .build();

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

实时接口返回示例：

{
    "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",        //数据更新时间
    }
}

空气质量查询API的典型应用场景

1. 健康类应用：为敏感人群提供实时空气质量建议，如哮喘患者出行规划。
2. 智能家居：联动空气净化设备，根据室外污染水平自动调节室内空气质量。
3. 城市规划：分析污染分布，优化交通管理或工业排放政策。
4. 公众信息服务：在网站或APP中集成AQI数据，如天气应用增强环境信息维度。

结语

空气质量查询API作为环境数据与终端应用的桥梁，其价值将持续增长。开发者可通过合理集成这些接口，为用户提供更智能的健康与环保服务，同时助力全球空气质量改善。

Last Updated on 2025-07-23 by admin