全国实时空气质量指数 API 数据接口
全国主要城市空气质量，极速响应数据，全国主要城市数据。
1. 产品功能
- 全国主要城市空气质量数据；
- 多负载响应节点，毫秒级响应性能；
- 包含主要污染物信息数据；
- 数据持续更新与维护；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
- 接口调用状态与状态监控
2. API 文档
接口详情: https://www.gugudata.com/api/details/airquality
接口地址: 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 | 首要污染物 |