数据规格
| 项目 | 规格 |
|---|---|
| 预报时效 | +0h ~ +360h(15 天),首行即起报时刻 |
| 时间分辨率 | 15 分钟,严格等间隔(96 点/天 × 15 天 = 1441 点) |
| 空间形式 | 单站点网格插值(提供经纬度即得单点序列) |
| 字段数量 | 19 个(站点标识 4 + 风场 4 + 地面要素 3 + 云量 4 + 辐射 4) |
| 起报频次 | 每次起报全量交付,新起报整体替换 |
| 交付形式 | CSV 文件(现支持);HTTP 查询接口(规范 V1.0,服务陆续开放) |
字段概览
| 分组 | 字段 | 说明 |
|---|---|---|
| 站点标识 | farm_id date_time lat lon | 场站编号、北京时间、站点坐标 |
| 风场 | spd10 dir10 spd100 dir100 | 10 m 与 100 m(轮毂高度附近)风速风向 |
| 地面要素 | sp t2m rh2 | 地面气压(Pa)、2 m 气温(K)、2 m 相对湿度(%) |
| 云量 | lcc mcc hcc tcc | 低 / 中 / 高 / 总云量(0-1 分数) |
| 太阳辐射 | dr sr rr tr | 直接 / 散射 / 反射 / 总辐射(J/m²,自起报时刻累积) |
完整类型、单位与取值说明见字段字典。
交付方式
CSV 文件交付(现支持)
- 按文件命名规范
weatherforecast_{lon}_{lat}_{yyyyMMddHH}.csv逐起报交付; - UTF-8(无 BOM)、英文逗号分隔、LF 换行、首行固定 19 列表头;
- 按起报时次全量覆盖,便于落库幂等处理。
HTTP 查询接口(规范 V1.0)
接口清单与参数规范已固化(/api/v1/farms、/api/v1/forecast/issues、/api/v1/forecast),字段命名、单位、累积口径与 CSV 完全一致,便于后续无缝切换。详见接口参考。
数据质量承诺
- 15 分钟严格等间隔,无跳点、无重复;
- 样例实测 1441 时间点 × 19 列全表零缺失;
- 辐射分量满足内部观测关系(rr ≈ 0.216 × tr,dr + sr ≈ 1.21 × tr),可程序化核对;
- 新起报文件到达后整体替换旧起报数据,杜绝混用。
常见问题
温度怎么是开尔文(K)?
t2m 为开尔文温标,摄氏度 = K − 273.15。
气压为什么数值很大?
sp 单位为帕斯卡(Pa),业务常用百帕请 ÷ 100。
辐射字段为什么一直变大?
四个辐射字段均为自起报时刻起的累积能量密度(J/m²),单调递增。取逐时段辐照度需差分:W/m² =(末时刻累积值 − 初时刻累积值)÷ 时段秒数(15 分钟即 ÷ 900)。
rr 是降雨量吗?
不是。rr 为地表反射短波辐射,不是降水量,请勿按降水字段接入。
更多单位换算与时区规则见使用注意事项。
