全国实时空气质量指数 API 接口详解 | 咕咕数据
获取全国主要城市的实时空气质量数据（AQI），支持毫秒级响应和丰富污染物指标，适用于环保监控、健康提醒、智能家居等应用场景。
内容目录
产品功能亮点
- 🌍 全国支持： 覆盖全国主要城市实时空气质量数据；
- ⚡ 极速响应： 多节点部署，支持高并发访问，毫秒级返回；
- 🧪 指标丰富： 提供 AQI、PM2.5、首要污染物等关键指标；
- 🧩 结构化数据： 支持直接嵌入前端/小程序/移动应用；
- 🛡️ 稳定可靠： 支持 HTTPS，全面兼容 Apple ATS；
- 📊 持续更新： 数据高频采集更新，确保实时性；
- 🔧 负载均衡架构： 多服务器构建，稳定性强；
- 🔍 状态监控平台： 实时监控链接
接口文档信息
-
接口地址：
https://api.gugudata.com/weather/airquality -
请求方式：
GET -
返回格式：
application/json; charset=utf-8 -
协议支持：
HTTPS
请求示例：
GET https://api.gugudata.com/weather/airquality?appkey=YOUR_APPKEY&city=北京
请求参数说明
| 参数名 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 咕咕数据平台申请的密钥 |
| city | string | 是 | 北京 | 需查询的城市名称，支持列表中任意一项（详见文末城市支持清单） |
返回字段详解
| 字段名 | 类型 | 描述 |
|---|---|---|
| DataStatus.StatusCode | int | 状态码 |
| DataStatus.StatusDescription | string | 状态说明 |
| DataStatus.ResponseDateTime | string | 接口响应时间 |
| DataStatus.DataTotalCount | int | 返回数据量（通常为 1） |
| Data.Province | string | 省份名称 |
| Data.City | string | 城市名称 |
| Data.AQI | string | 空气质量指数（AQI） |
| Data.Quality | string | 空气质量等级，如“良”、“轻度污染”等 |
| Data.PM25 | string | PM2.5 浓度值 |
| Data.PrimaryPollutant | string | 首要污染物，如“PM2.5”、“臭氧”等 |
典型应用场景
- 🧘 健康类 App： 推送空气质量提醒和运动建议；
- 🏠 智能家居系统： 联动空气净化设备启停；
- 📱 天气/生活类小程序： 显示城市 AQI 和 PM2.5 曲线；
- 📍 城市环境监控： 多城市空气状况实时地图展示；
- 🧳 出行规划系统： 为旅行路线规划提供环境参考。
测试入口与数据预览
延伸阅读
咕咕数据 —— 提供稳定可靠的结构化环境数据服务，为每一个“清新呼吸”保驾护航。
了解更多请访问：www.gugudata.com
