历史预报数据 API
查询过去各个起报时刻生成的预报结果，用于预报验证、模型对比和天气事件复盘。
适用场景
历史预报数据回答“模型在过去某个时间点预测了什么”，而不是“当时实际发生了什么”。请求必须提供模型和起报时间。
起报时间是模型运行的时间，例如 2025-05-15T00:00 表示模型在该时刻生成了一次未来天气预报。
请求示例
下面的请求获取 GFS 在 2025 年 5 月 15 日 00
起报后 48 小时的逐小时气温和逐日最高气温：https://api.mirror-earth.com/v1/archive-forecast?latitude=32&longitude=118&hourly=temperature_2m&daily=temperature_2m_max&models=archive_gfs&start_hour=2025-05-15T00:00&timezone=Asia/Shanghai&forecast_hours=48&apikey=您的API Key
请求参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
| apikey必填 | string | API Key，登陆后自动填充，或在个人中心获取 |
| latitude必填 | number | 纬度 |
| longitude必填 | number | 经度 |
| start_hour必填 | string | 起报时间，使用 ISO 8601 格式，例如 2025-05-15T00:00 |
| models必填 | string | 历史预报模型，多个模型用逗号分隔，例如 archive_gfs,archive_ifs |
| hourly选填 | string | 小时要素，多个要素用逗号分隔：temperature_2m,precipitation |
| daily选填 | string | 逐日要素，多个要素用逗号分隔：temperature_2m_max,temperature_2m_min,precipitation_sum |
| forecast_hours选填 | number | 预报小时长度，默认168小时 |
| temporal_resolution选填 | string | 时间分辨率，默认都是1小时(hourly_1)，可选10分钟(minutely_10)，15分钟(minutely_15)，30分钟(minutely_30) |
| timezone选填 | string | 时区，默认为世界时，auto表示根据经度自动计算全部时区：时区列表 |
| cell_selection选填 | string | 坐标选取偏好，当坐标点位于陆地和海洋分界处时控制返回海洋上的点还是陆地上的点，默认是land表示陆地，sea（海洋），nearest （就近原则） |
| elevation选填 | string | 高程，默认情况下会使用高程对温度数据进行校正，数值模式算出来的数据表示的是这个网格点上的平均，我们用高程可以根据地形进行校准，nan表示不校准。 |
数据源
| 标识符 | 来源 | 分辨率 | 预报时长 | 可用时间 |
|---|---|---|---|---|
archive_ifs | ECMWF | 25 km | 360 小时 | 2023-01-01 至今 |
archive_hres | ECMWF | 9 km | 360 小时 | 2019-01-01 至今 |
archive_gfs | NOAA | 25 km | 384 小时 | 2023-07-01 至今 |
archive_aifs | ECMWF AI 模型 | 25 km | 360 小时 | 2025-09-19 至今 |
archive_graphcast | NOAA AI 模型 | 25 km | 384 小时 | 2025-09-19 至今 |
archive_cma | 中国气象局 | 12.5 km | 108 小时 | 2025-09-19 至今 |
archive_gem | 加拿大气象局 | 15 km | 240 小时 | 2025-09-19 至今 |
archive_icon | DWD | 11 km | 168 小时 | 2025-09-19 至今 |
archive_jma | 日本气象厅 | 50 km | 264 小时 | 2025-09-19 至今 |
archive_kma | 韩国气象厅 | 12 km | 288 小时 | 2025-09-19 至今 |
archive_mfa | 法国气象局 | 25 km | 96 小时 | 2025-09-19 至今 |
archive_ukmo | 英国气象局 | 10 km | 168 小时 | 2025-09-19 至今 |
模型详情页包含该模型实际支持的变量。变量名称与单位统一参考逐小时变量目录。
响应说明
响应结构与其他天气 API 一致，包含 hourly、daily 及对应的单位字段。不同模型的原始数据起始时间可能不同，接口统一从请求的起报时间开始返回，原始缺失位置以 nan 表示。