Skip to content

使用注意事项

接入前必读的七条规则,全部来自样例数据实测。

时区

文件内容 date_time 为北京时间,文件名起报时间为 UTC,换算相差 8 小时。详见时间规范

温度单位

t2m 为开尔文(K),直接按摄氏度使用会偏差 273.15:

python
df["t2m_c"] = df["t2m"] - 273.15

气压单位

sp 为帕斯卡(Pa),业务常用百帕(hPa):

python
df["sp_hpa"] = df["sp"] / 100

太阳辐射累积量

必须做差分才能得到逐时段辐照度,不可直接当瞬时值使用

text
W/m² = (末时刻累积值 − 初时刻累积值) ÷ 时段秒数    # 15 分钟步长即 ÷ 900
  • 夜间累积值保持不变(平台期),可用于判别日出日落时段;
  • 在线体验页可切换两种口径直观查看。

rr 不是降雨量

rr反射辐射(地表反射短波),不是降水量,请勿按降水字段接入。样例中它满足 rr ≈ 0.216 × tr,可用作数据核对。

云量越界

云量为 0-1 分数(非百分数),网格插值可能导致轻微越界(样例实测 -0.18 至 1.13),建议截断:

python
df[["lcc", "mcc", "hcc", "tcc"]] = df[["lcc", "mcc", "hcc", "tcc"]].clip(0, 1)

新文件整体替换

新起报文件到达后应整体替换旧起报的预报数据,避免混用不同起报时次。按 farm_id + issue 建立分区或版本键即可实现幂等落库。

附:自检清单

检查项期望值
行数1441(15 天 × 96 点/天,含首末时刻)
列数19,顺序与文件格式规范一致
时间间隔严格 15 分钟等间隔,无跳点无重复
缺失空字符串表示缺失(样例实测全表无缺失)
辐射单调性dr / sr / rr / tr 随时间单调不减
辐射一致性rr ≈ 0.216 × tr;dr + sr ≈ 1.21 × tr

好天气数据 · 场站级数值预报数据服务