环境空气质量实况观测

访问限制

本部分 API 属于增值服务，仅提供给企业套餐开发者，如需采购请联系彩云商务

数据说明

• 空间分辨率：中国大陆观测站级别
• 更新频率：1 小时
• 覆盖范围见 覆盖范围

站点实况

请求

GET https://api.caiyunapp.com/v1/aqi/latest

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权

请求示例

curl "https://api.caiyunapp.com/v1/aqi/latest?token={token}"

响应示例

{
  "status": "ok",
  "category": "aqi_latest_obs_city",
  "result": {
    "0000A03460": {
      "lon": 117.4067,
      "lat": 40.0583,
      "area": "天津市",
      "position_name": "北环路",
      "province_name": "天津市",
      "station_code": "0000A03460",
      "time_point": "2021-12-29T14:00:00Z+08:00",
      "aqi": 21,
      "pm25": 3,
      "pm10": 15,
      "co": 0.5,
      "so2": 6,
      "o3": 66,
      "no2": 5,
      "quality": "优",
      "primary_pollutant": null
    }
    // ...
  }
}

响应字段

JSONPath	类型	说明
$.status	string	请求状态
$.category	string	数据类别
$.result	object	以站点 ID 为键的数据
$.result.*.lon	number	经度
$.result.*.lat	number	纬度
$.result.*.area	string	城市
$.result.*.position_name	string	站点名称
$.result.*.province_name	string	省级行政区
$.result.*.station_code	string	站点编号
$.result.*.time_point	string	观测时间
$.result.*.aqi	number	AQI
$.result.*.pm25	number	PM2.5，μg/m³
$.result.*.pm10	number	PM10，μg/m³
$.result.*.co	number	CO，mg/m³
$.result.*.so2	number	SO₂，μg/m³
$.result.*.o3	number	O₃，μg/m³
$.result.*.no2	number	NO₂，μg/m³
$.result.*.quality	string	空气质量等级
$.result.*.primary_pollutant	string/null	首要污染物

城市实况排名

请求

GET http://api.caiyunapp.com/v1/aqi/ranking

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
number	否	100	1~200	返回城市数量
field	否	pm25	pm25、pm10、o3、co、no2、so2、aqi	排名字段
type	否	asc	asc、desc	排序方向

请求示例

curl "http://api.caiyunapp.com/v1/aqi/ranking?number=10&type=desc&field=pm25&token={token}"

响应示例

{
  "status": "ok",
  "category": "aqi_latest_obs_city_ranking",
  "result": [
    {
      "lon": 129.5029,
      "lat": 48.471,
      "area": "伊春市",
      "position_name": "汤旺河国家公园(对照点)",
      "province_name": "黑龙江省",
      "station_code": "0000A02254",
      "time_point": "2021-12-29T14:00:00Z+08:00",
      "aqi": 4,
      "pm25": 0,
      "pm10": 2,
      "co": 0.4,
      "so2": 6,
      "o3": 70,
      "no2": 1,
      "quality": "优",
      "primary_pollutant": null
    }
  ]
}

响应字段

JSONPath	类型	说明
$.status	string	请求状态
$.category	string	数据类别
$.result	array<object>	城市排名数据
$.result[].lon	number	经度
$.result[].lat	number	纬度
$.result[].area	string	城市
$.result[].position_name	string	站点名称
$.result[].province_name	string	省级行政区
$.result[].station_code	string	站点编号
$.result[].time_point	string	观测时间
$.result[].aqi	number	AQI
$.result[].pm25	number	PM2.5，μg/m³
$.result[].pm10	number	PM10，μg/m³
$.result[].co	number	CO，mg/m³
$.result[].so2	number	SO₂，μg/m³
$.result[].o3	number	O₃，μg/m³
$.result[].no2	number	NO₂，μg/m³
$.result[].quality	string	空气质量等级
$.result[].primary_pollutant	string/null	首要污染物