实时预报 API
查询未来天气预报，支持多个数值天气预报和 AI 预报模型。
适用场景
实时预报 API 用于查询当前及未来的天气预报，支持按经纬度、时间范围、模型和变量获取数据。
如果需要查询已经发生的天气，请使用历史数据 API；如果需要复盘过去某个起报时刻的预测，请使用历史预报数据 API。
请求示例
下面的请求获取南京未来 15 天的逐小时气温和逐日最高气温：
https://api.mirror-earth.com/v1/forecast?latitude=32&longitude=118&hourly=temperature_2m&daily=temperature_2m_max&timezone=Asia/Shanghai&forecast_days=15&temporal_resolution=hourly_1&models=ecmwf&apikey=您的API Key
请求参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
| apikey必填 | string | API Key，登陆后自动填充，或在个人中心获取 |
| latitude必填 | number | 纬度，多个纬度用逗号分隔，必须和longitude数量一致，例如 32,33 |
| longitude必填 | number | 经度，多个经度用逗号分隔，必须和latitude数量一致，例如 118,119 |
| hourly选填 | string | 小时要素，多个要素用逗号分隔：temperature_2m,precipitation |
| daily选填 | string | 逐日要素，多个要素用逗号分隔：temperature_2m_max,temperature_2m_min,precipitation_sum |
| forecast_days选填 | number | 预报天数，可以和past_days同时使用，但是不能和start_date/end_date/start_hour/end_hour同时使用 |
| past_days选填 | number | 过去天数，可以和forecast_days同时使用，但是不能和start_date/end_date/start_hour/end_hour同时使用 |
| start_date选填 | string | 开始日期，只能搭配end_date使用，例如 2025-01-01 |
| end_date选填 | string | 结束日期，只能搭配start_date使用，例如 2025-01-02 |
| start_hour选填 | number | 开始时间，只能搭配end_hour使用，例如 2025-01-01T00:00 |
| end_hour选填 | number | 结束时间，只能搭配start_hour使用，例如 2025-01-01T23:00 |
| temporal_resolution选填 | string | 时间分辨率，默认都是1小时(hourly_1)，可选10分钟(minutely_10)，15分钟(minutely_15)，30分钟(minutely_30) |
| models选填 | string | 模型标识符，多个模型用逗号分隔；默认使用 ecmwf |
| timezone选填 | string | 时区，默认为世界时，auto表示根据经度自动计算全部时区：时区列表 |
| cell_selection选填 | string | 坐标选取偏好，当坐标点位于陆地和海洋分界处时控制返回海洋上的点还是陆地上的点，默认是land表示陆地，sea（海洋），nearest （就近原则） |
| elevation选填 | string | 高程，默认情况下会使用高程对温度数据进行校正，数值模式算出来的数据表示的是这个网格点上的平均，我们用高程可以根据地形进行校准，nan表示不校准。 |
响应结构
{
"hourly_units": {
"time": "iso8601",
"temperature_2m": "°C"
},
"hourly": {
"time": ["2026-01-01T00:00", "2026-01-01T01:00"],
"temperature_2m": [1.85, 4.25]
},
"daily_units": {
"time": "iso8601",
"temperature_2m_max": "°C"
},
"daily": {
"time": ["2026-01-01"],
"temperature_2m_max": [7.2]
}
}time 与变量数组按相同下标对应，单位在 hourly_units 或 daily_units 中声明。缺失值以 null 表示。
模型选择
| 标识符 | 来源 | 分辨率 | 预报时长 |
|---|---|---|---|
ecmwf | ECMWF | 25 km | 15 天 |
ecmwf_ifs | ECMWF | 9 km | 15 天 |
gfs | NOAA | 13 km | 16 天 |
icon | DWD | 11 km | 7 天 |
cma | 中国气象局 | 12.5 km | 4.5 天 |
gem | 加拿大气象局 | 15 km | 10 天 |
jma | 日本气象厅 | 50 km | 11 天 |
kma | 韩国气象厅 | 12 km | 12 天 |
meteofrance | 法国气象局 | 25 km | 4 天 |
ukmo | 英国气象局 | 10 km | 7 天 |
aifs | ECMWF AI 模型 | 25 km | 15 天 |
graphcast | NOAA AI 模型 | 25 km | 16 天 |
模型详情页包含该模型实际支持的变量和等压面。变量名称与单位统一参考逐小时变量目录。