全国实时空气质量指数 API 接口
接口详情官网地址: https://www.gugudata.com/api/details/airquality
全国实时空气质量指数 API 全国主要城市空气质量，基础数据等关键词场景常会用到，适合用于天气与天文信息查询、出行、旅游与本地化服务与环境信息展示与预测支持等业务场景，方便开发者直接在应用、脚本或数据流程中接入。
1. 产品功能
- 全国主要城市空气质量数据；
- 多负载响应节点，毫秒级响应性能；
- 包含主要污染物信息数据；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
2. API 文档
接口地址: https://api.gugudata.com/weather/airquality
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/weather/airquality?appkey=YOUR_APPKEY&city=YOUR_VALUE
数据预览: https://www.gugudata.com/preview/airquality
接口测试: https://api.gugudata.com/weather/airquality/demo
3. 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
| city | string | 是 | YOUR_VALUE | 需要查询的城市名称，可选值为：[‘北京’, ‘廊坊’, ‘承德’, ‘唐山’, ‘晋城’, ‘保定’, ‘德阳’, ‘秦皇岛’, ‘天津’, ‘朝阳’, ‘临汾’, ‘运城’, ‘焦作’, ‘成都’, ‘锦州’, ‘长治’, ‘绵阳’, ‘资阳’, ‘葫芦岛’, ‘长春’, ‘广安’, ‘石家庄’, ‘三门峡’, ‘兰州’, ‘沧州’, ‘沈阳’, ‘衡水’, ‘哈尔滨’, ‘洛阳’, ‘滨州’, ‘眉山’, ‘阳泉’, ‘东营’, ‘内江’, ‘铜川’, ‘晋中’, ‘淄博’, ‘邢台’, ‘宜宾’, ‘自贡’, ‘南充’, ‘邯郸’, ‘潍坊’, ‘新乡’, ‘安阳’, ‘忻州’, ‘太原’, ‘临沂’, ‘重庆’, ‘乐山’, ‘张家口’, ‘德州’, ‘济南’, ‘鹤壁’, ‘聊城’, ‘青岛’, ‘亳州’, ‘日照’, ‘枣庄’, ‘西安’, ‘咸阳’, ‘宿州’, ‘宝鸡’, ‘达州’, ‘泰安’, ‘商丘’, ‘郑州’, ‘济宁’, ‘连云港’, ‘南阳’, ‘吕梁’, ‘雅安’, ‘阜阳’, ‘渭南’, ‘南昌’, ‘周口’, ‘许昌’, ‘宿迁’, ‘武汉’, ‘开封’, ‘泸州’, ‘平顶山’, ‘徐州’, ‘驻马店’, ‘信阳’, ‘菏泽’, ‘淮南’, ‘孝感’, ‘漯河’, ‘朔州’, ‘濮阳’, ‘杭州’, ‘呼和浩特’, ‘银川’, ‘湖州’, ‘随州’, ‘淮安’, ‘遂宁’, ‘襄阳’, ‘宜昌’, ‘淮北’, ‘常州’, ‘益阳’, ‘拉萨’, ‘泰州’, ‘包头’, ‘盐城’, ‘六安’, ‘蚌埠’, ‘岳阳’, ‘西宁’, ‘九江’, ‘镇江’, ‘苏州’, ‘广州’, ‘乌鲁木齐’, ‘贵阳’, ‘大同’, ‘铜陵’, ‘新余’, ‘荆门’, ‘鄂州’, ‘扬州’, ‘常德’, ‘无锡’, ‘荆州’, ‘南通’, ‘咸宁’, ‘长沙’, ‘衢州’, ‘嘉兴’, ‘大连’, ‘黄冈’, ‘温州’, ‘黄石’, ‘绍兴’, ‘厦门’, ‘宜春’, ‘合肥’, ‘上海’, ‘昆明’, ‘福州’, ‘株洲’, ‘金华’, ‘南京’, ‘湘潭’, ‘马鞍山’, ‘丽水’, ‘萍乡’, ‘宣城’, ‘芜湖’, ‘滁州’, ‘池州’, ‘安庆’, ‘佛山’, ‘黄山’, ‘江门’, ‘台州’, ‘南宁’, ‘惠州’, ‘宁波’, ‘肇庆’, ‘舟山’, ‘中山’, ‘东莞’, ‘深圳’, ‘珠海’, ‘海口’]。 |
4. 返回参数
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 此条件下的总数据量 |
| Data.Province | string | 省份名称 |
| Data.City | string | 城市名称 |
| Data.AQI | string | 空气质量指数 |
| Data.Quality | string | 空气质量 |
| Data.PM25 | string | PM2.5 浓度 |
| Data.PrimaryPollutant | string | 首要污染物 |
5. 错误码说明
| 状态码 | 错误说明 | 备注 |
|---|---|---|
| 100 | 正常返回 | - |
| 101 | 参数错误 | - |
| 102 | 请求频率受限 | 每分钟请求不能超过 100 次 |
| 103 | 账号欠费 | - |
| 104 | APPKEY 错误 | 请检查传递的 APPKEY 是否为开发者中心获取到的值 |
| 110 | 接口响应错误 | - |
6. 适用场景
- 适合用于天气与天文信息查询，快速补齐产品侧需要的 全国实时空气质量指数 数据能力。
- 适合用于出行、旅游与本地化服务，减少手工整理、清洗与重复开发成本。
- 适合用于环境信息展示与预测支持，将接口结果直接接入后台系统、数据任务或内容处理流程。
7. 相关接口
- 可搭配使用：
农历与二十四节气，适合补充同类场景的接口能力。 - 可搭配使用：
日出与日落时间，适合补充同类场景的接口能力。 - 可搭配使用：
全国天气预报信息，适合补充同类场景的接口能力。
–EOF–
转载须以超链接形式标明文章原始出处和作者信息
