历史数据 API

查询 1940 年至今的历史再分析数据和等压面数据。

适用场景

历史数据 API 用于查询已经发生的天气，适合气候分析、历史统计和模型训练。当前主要数据源为 ERA5 地面数据和 ERA5 等压面数据。

如果需要查询未来天气，请使用实时预报 API；如果需要查询某次历史起报结果，请使用历史预报数据 API。

请求示例

下面的请求获取南京 2023 年 1 月 1 日至 7 日的逐小时气温和逐日最高气温：

https://api.mirror-earth.com/v1/archive?latitude=32&longitude=118&hourly=temperature_2m&daily=temperature_2m_max&start_date=2023-01-01&end_date=2023-01-07&models=era5&timezone=Asia/Shanghai&apikey=您的API Key

请求参数说明

参数名	类型	描述
apikey必填	string	API Key，登陆后自动填充，或在个人中心获取
latitude必填	number	纬度，多个纬度用逗号分隔，必须和longitude数量一致，例如 32,33,34
longitude必填	number	经度，多个经度用逗号分隔，必须和latitude数量一致，例如 118,119,120
hourly选填	string	小时要素，多个要素用逗号分隔：temperature_2m,precipitation
daily选填	string	逐日要素，多个要素用逗号分隔：temperature_2m_max,temperature_2m_min,precipitation_sum
start_date选填	string	开始日期，与start_hour/end_hour互斥，例如 2025-01-01
end_date选填	string	结束日期，与start_hour/end_hour互斥，例如 2025-01-02
start_hour选填	number	开始时间，与start_date/end_date互斥，例如 2025-01-01T00:00
end_hour选填	number	结束时间，与start_date/end_date互斥，例如 2025-01-01T23:00
temporal_resolution选填	string	时间分辨率，默认都是1小时(hourly_1)，可选10分钟(minutely_10)，15分钟(minutely_15)，30分钟(minutely_30)
models选填	string	可选 era5、era5_pressure，推荐使用整合两者的 era5_seamless
timezone选填	string	时区，默认为世界时，auto表示根据经度自动计算全部时区：时区列表
cell_selection选填	string	坐标选取偏好，当坐标点位于陆地和海洋分界处时控制返回海洋上的点还是陆地上的点，默认是land表示陆地，sea（海洋），nearest （就近原则）
elevation选填	string	高程，默认情况下会使用高程对温度数据进行校正，数值模式算出来的数据表示的是这个网格点上的平均，我们用高程可以根据地形进行校准，nan表示不校准。

数据源

标识符	内容	适用场景
`era5`	地面再分析数据	地面天气和长期时间序列
`era5_pressure`	37 个标准等压面数据	高空温度、湿度、风场分析
`era5_seamless`	整合地面与等压面能力	需要统一查询入口的场景