环境空气质量站点预报

访问限制

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

数据介绍

预报质量

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

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

预报效果

广州

东莞

江门

佛山

临近站点预报 API

• 错误信息

请求

GET https://singer.caiyunhub.com/v3/aqi/forecast/station

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
longitude	是	—	—	经度
latitude	是	—	—	纬度
hours	否	1	1~120	返回小时数

请求示例

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

响应示例

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

响应字段

JSONPath	类型	说明
$.data	array<object>	临近站点预报
$.data[].station_id	string	站点 ID
$.data[].data	array<object>	逐小时预报数据
$.data[].data[].id	string	站点 ID
$.data[].data[].timestamp	number	预报时间
$.data[].data[].aqi	number	AQI，国标
$.data[].data[].pm25	number	PM2.5，μg/m³
$.data[].data[].pm10	number	PM10，μg/m³
$.data[].data[].so2	number	SO₂，μg/m³
$.data[].data[].no2	number	NO₂，μg/m³
$.data[].data[].o3	number	O₃，μg/m³
$.data[].data[].co	number	CO，mg/m³
$.data[].data[].date	string	日期

站点预报 NC 文件 API

接口说明

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

• 错误信息

请求

GET http://singer.caiyunhub.com/v3/aqi/forecast/nc

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
limit	否	1	1~72	返回条数

请求示例

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

响应示例

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

响应字段

JSONPath	类型	说明
$.items	array<object>	数据列表
$.items[].start_ts	number	起报时间时间戳
$.items[].start_time	string	起报时间（ISO）
$.items[].url	string	NC 文件链接

NC 文件说明

nc 文件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	最后一帧观测数据的时间