空气质量预报

访问限制

本部分 API 属于增值服务，开发者 Token 需要额外开通权限，请联系商务

数据介绍

预报质量

彩云天气自主研发的空气质量智能预报模型，参加 2024 年国家环境空气质量预报模型比赛，经检验预报数据及时性、准确性等位列前茅。鉴于法律法规要求及保密协议要求，需要进一步了解技术情况请联系商务。

空间分辨率：中国大陆观测站级别
时间分辨率
- 当前至未来 120 小时
- 逐小时更新
支持要素：PM2.5/PM10/O3/SO2/NO2/CO

预报效果

广州

东莞

江门

佛山

临近站点预报 API

bash

curl "https://singer.caiyunhub.com/v3/aqi/forecast/station?token={token}&longitude=116.3883&latitude=39.9289&hours=120"

longitude: 经度
latitude: 纬度
hours: 多少个小时，默认 1，最大 120

jsonc

{
  "data": [
    {
      "station_id": "xxxxx",
      "data": [
        // ...
      ]
    },
    {
      "station_id": "yyyyy",
      "data": [
        // ...
      ]
    }
  ]
}

Field	Type	Description
id	string	站点 ID
timestamp	int64	预报时间
aqi	int64	AQI, 国标
pm25	int64	PM 2.5, μg/m3
pm10	int64	PM 10, μg/m3
so2	int64	SO2, μg/m3
no2	int64	NO2, μg/m3
o3	int64	O3, μg/m3
co	float	CO, mg/m3
date	string	日期

NC API

接口说明

空气质量站点预报 NC 文件 API

bash

curl "http://singer.caiyunhub.com/v3/aqi/forecast/nc?token={token}&limit=1"

limit: 限制返回条数，默认 1，最大 72

jsonc

{
  "items": [
    {
      "start_ts": 1739854800,
      "start_time": "2025-02-18T05:00:00Z",
      "url": "..."
    },
    // ...
    {
      "start_ts": 1739844000,
      "start_time": "2025-02-18T02:00:00Z",
      "url": "..."
    }
  ]
}

Field	Type	Description
items	list	数据列表
items.#.start_ts	int64	起报时间时间戳
items.#.start_time	string	起报时间（ISO）
items.#.url	string	NC 文件链接

NC 文件说明

nc 文件python读取代码示例

python

import xarray as xr

fp = "nc_file_path"

ds = xr.open_dataset(fp)

文件变量说明

Field	Terminology	Type	Description
station	Coordinates	string	站点 ID
time	Coordinates	datetime64[ns]	数据时间（观测时间+预报时间）
AQI	Data variables	float32	AQI, 国标
PM2.5	Data variables	float32	PM 2.5, μg/m3
PM0	Data variables	float32	PM 10, μg/m3
NO2	Data variables	float32	NO2, μg/m3
O3	Data variables	float32	O3, μg/m3
nwp_start	Attributes	int	气象数据起报时间戳
t0	Attributes	string	最后一帧观测数据的时间

空气质量预报 ​

数据介绍 ​

预报效果 ​

临近站点预报 API ​

NC API ​

接口说明 ​

NC 文件说明 ​