一、引言

空气质量，看不见摸不着，却时刻影响着我们的健康。对空气质量敏感的人来说，选择一个好环境，不仅是对身体的负责，更是对生活品质的追求。同时，准确的空气质量数据也是城市规划、环境研究的重要依据。全国空气质量查询API，正是这样一个贴心的助手，它提供了全国300多个城市的空气质量实时数据，帮助我们随时掌握身边的空气状况。

二、应用场景

（一）环境科研与城市规划

环境科研人员可以通过API获取长期的空气质量数据，分析污染趋势，评估治理效果。城市规划者则能依据这些数据，合理布局绿化区域、工业区和居民区，打造更宜居的城市环境。

（二）智能家居系统集成

想象一下，当室外空气质量下降时，您的智能家居系统能自动感知并调整室内空气净化器的运行模式，确保室内空气始终清新宜人。这一切都可以通过将全国空气质量查询API与智能家居系统集成来实现。

（三）旅游与户外活动决策

对于热爱旅行和户外活动的人来说，了解目的地的空气质量至关重要。通过API查询目的地的空气质量，可以帮助游客做出更明智的旅行决策，选择空气质量优良的日子出行，尽情享受大自然的美好。

三、API接口功能与技术说明

1. 功能概览

全国空气质量查询API包含三个子接口：
城市空气质量实时查询：查询单个城市的实时空气质量数据。
城市空气质量排行：按空气质量排名列出全国城市，助力比较分析。
近14天空气质量查询：显示城市空气质量的历史趋势图，支持长周期分析。

2.以下以“城市空气质量实时查询”为例，详细介绍参数与功能：

以城市空气质量实时查询为例
接口地址：https://api.tanshuapi.com/api/air_quality/v1/index
返回格式：json
请求方式：不限
接口备注： 每半小时更新全国300+个城市数据。
请求参数说明:

返回参数说明:

JSON返回示例:

{
"code": 1,
"msg": "操作成功",
-"data": {
"primary_pollutant": "",
"aqi": "34",
"pm10": "34",
"ct": "2025-04-27 14:40:00.034",
"area": "南昌",
"co": "0.9",
"o3": "26",
"area_code": "nanchang",
"num": "116",
"no2": "32",
"so2": "8",
"o3_8h": "_",
"quality": "优质"
"pm2_5": "19"
}
}

Python代码示例

import requests

def get_air_quality(area):
    # API接口地址
    api_url = "https://api.tanshuapi.com/api/air_quality/v1/index"

    # API密钥（需替换为您个人的API密钥）
    api_key = "your_api_key_here"

    # 构建请求参数
    params = {
        "key": api_key,
        "area": area
    }

    # 发送GET请求
    response = requests.get(api_url, params=params)

    # 解析返回结果
    if response.status_code == 200:
        result = response.json()
        if result["code"] == 1:
            data = result["data"]
            print(f"地区：{data['area']}")
            print(f"空气质量指数（AQI）：{data['aqi']}")
            print(f"主要污染物：{data['primary_pollutant']}")
            print(f"PM2.5浓度：{data['pm2_5']} μg/m³")
            print(f"PM10浓度：{data['pm10']} μg/m³")
            print(f"二氧化氮（NO2）浓度：{data['no2']} μg/m³")
            print(f"二氧化硫（SO2）浓度：{data['so2']} μg/m³")
            print(f"一氧化碳（CO）浓度：{data['co']} mg/m³")
            print(f"臭氧（O3）浓度：{data['o3']} μg/m³")
            print(f"空气质量等级：{data['quality']}")
            print(f"数据更新时间：{data['ct']}")
        else:
            print(f"查询失败，错误信息：{result['msg']}")
    else:
        print(f"请求失败，状态码：{response.status_code}")

# 示例调用
get_air_quality("南昌")

四、总结

全国空气质量查询 API 可不单单是个查询的工具，它更像是一座桥梁，能带着我们走向健康又智能的生活。想一想，搞环境科研的时候，有了它提供的数据支持，研究工作都轻松不少。智能家居也因为它注入了环保的元素，变得更贴心。出去旅游或者日常出行，它还能给我们把把关，让出行更安心。
现在物联网技术越来越发达，以后我们的生活肯定会变得更智能、更环保、也更健康。空气质量好不好，和我们的生活还有地球的未来都息息相关。咱们就从关注空气质量开始，一起努力守护我们的健康，还有咱们的地球家园吧。