空气指数对日常生活的吃穿住行有指导作用，像涉及到天气工具的APP、文旅出行之类的场景，每日的空气质量是必须要呈现的。

本文以探数API的全国空气质量查询接口为例，讲解怎么接入此类接口。

## 接口应用场景

1. 天气/运动小程序：展示AQI，给出行、运动建议
2. 智能家居：新风系统调节、联动净化器
3. 智慧城市大屏：环保看板、重污染预警
4. 数据分析：历史空气质量统计、环评科研

## 接口说明
- 请求参数：城市名称

- 可查询信息：实时空气质量、空气质量排行、近14天空气质量

- 查询范围：支持全国300+城市

- 更新频率：半小时

## 返回数据示例
```json
{
-"data": {
"primary_pollutant": "细颗粒物(PM2.5)",//首要污染物
"aqi": "104",//空气质量指数(AQI)
"pm10": "89", //颗粒物（粒径小于等于10μm）1小时平均，μg/m³
"ct": "2026-11-12 09:40:00.013",//发布时间
"area": "北京",//城市
"co": "0.9", //一氧化碳1小时平均，mg/m³
"o3": "10", //臭氧1小时平均，μg/m³
"area_code": "beijing",
"num": "281", //排行
"no2": "35",//二氧化氮1小时平均，μg/m³
"so2": "3",//二氧化硫一小时平均，μg/m³
"o3_8h": "_", //臭氧8小时滑动平均，μg/m³
"quality": "轻度污染",//空气质量指数类别，6类：优质、良好、轻度污染、中度污染、重度污染、严重污染。
"pm2_5": "64"//颗粒物（粒径小于等于2.5μm）1小时平均，μg/m³
}
}
```

### AQI 国标等级映射规则

接口自带quality字段可直接使用；如果需要自定义文案、告警逻辑，可参考国标：

0–50：优
51–100：良
101–150：轻度污染
151–200：中度污染
201–300：重度污染
＞300：严重污染

##接入示例

curl 示例
```bash
curl -H "Authorization: Bearer 你的token" "https://api.tanshuapi.com/api/air/now?city=城市名"

```

Python 示例
```python
import requests

url = "https://api.tanshuapi.com/api/air_quality/v1/index"#接口地址
headers = {
    "Authorization": "Bearer 你的token"
}
params = {
    "city": "城市名"
}
try:
    res = requests.get(url, headers=headers, params=params, timeout=10)
    ret = res.json()
    if ret["code"] == 200:
        data = ret["data"]
        print("AQI：", data["aqi"])
        print("空气质量等级：", data["quality"])
        print("PM2.5：", data["pm2_5"])
        print("PM10：", data["pm10"])
        # o3_8h 存在返回下划线的空标识，需要做兼容
        o3_8h = data["o3_8h"] if data["o3_8h"] != "_" else "无数据"
        print("臭氧8小时均值：", o3_8h)
except Exception as e:
    print("接口请求异常：", e)

```

## 产环境最佳实践

**缓存策略**：使用 Redis 缓存，缓存时长设置 30 分钟，和数据源更新周期对齐，减少调用量、节约成本
**空值兼容**：部分字段如`o3_8h`会返回`_`，代码中要做判断，避免页面渲染报错


空气指数对日常生活的吃穿住行有指导作用，像涉及到天气工具的APP、文旅出行之类的场景，每日的空气质量是必须要呈现的。

开发实战|全国空气质量查询API接入教程

空气质量数据是天气、文旅、智能家居项目的常用能力。本文以探数全国空气质量查询接口为例，介绍接口参数、返回字段，附带 curl、Python接入代码。

开发工具

后端

物联网

探数API全国空气质量查询接口，覆盖300+城市，实时更新半小时，提供AQI、PM2.5等关键指标。支持天气小程序、智能家居、城市大屏等场景，附curl和Python接入示例，含Redis缓存策略及国标等级映射，助您快速集成并优化性能。

数据分析

代码解释

Python

Redis

JSON

腾讯云双十一大促

bigdata-class

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

开发实战|全国空气质量查询API接入教程-腾讯云开发者社区-腾讯云

开发实战|全国空气质量查询API接入教程

开发实战|全国空气质量查询API接入教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐