历史数据API
对历史上已经发生的气象数据的观测，我们提供1940年到现在的历史气象数据。
获取某地逐小时历史数据
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&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表示根据经度自动计算全部时区：时区列表 |
返回结果：
{
...
"hourly_units":{"time":"iso8601","temperature_2m":"°C"},
"daily_units":{"time":"iso8601","temperature_2m_max":"°C"},
"hourly": {
"time": ["2022-01-01T00:00","2022-01-01T01:00", ...],
"temperature_2m": [1.85,4.25,5.40,6.05,6.55,7.15,7.55,7.65,7.35, ...]
},
"daily": {
"time": ["2022-01-01", "2022-01-02", ...],
"temperature_2m_max": [7.2, 6.5, 4.3, ...]
}
}- hourly_units: 逐小时要素单位
- daily_units: 逐日要素单位
- hourly: 逐小时数据列表
- daily: 逐日数据列表
历史数据源
era5: 提供地面数据 era5_pressure：提供37层等压面数据
ERA5历史数据要素总览
| 名称 | 单位 | 说明 |
|---|---|---|
| 温度类 | ||
| temperature_2m | °C | 2米气温 |
| apparent_temperature | °C | 体感温度 |
| wet_bulb_temperature_2m | °C | 2米湿球温度 |
| dew_point_2m | °C | 2米露点温度 |
| soil_temperature_0_to_7cm | °C | 0-7厘米土壤温度 |
| soil_temperature_7_to_28cm | °C | 7-28厘米土壤温度 |
| soil_temperature_28_to_100cm | °C | 28-100厘米土壤温度 |
| soil_temperature_100_to_255cm | °C | 100-255厘米土壤温度 |
| soil_temperature_0_to_100cm | °C | 0-100厘米土壤温度 |
| 湿度类 | ||
| relative_humidity_2m | % | 2米相对湿度 |
| vapor_pressure_deficit | hPa | 饱和水汽压差 |
| vapour_pressure_deficit | hPa | 水汽压差 |
| total_column_integrated_water_vapour | kg/m² | 整层水汽含量 |
| soil_moisture_0_to_7cm | m³/m³ | 0-7厘米土壤湿度 |
| soil_moisture_7_to_28cm | m³/m³ | 7-28厘米土壤湿度 |
| soil_moisture_28_to_100cm | m³/m³ | 28-100厘米土壤体积含水量 |
| soil_moisture_100_to_255cm | m³/m³ | 100-255厘米土壤体积含水量 |
| soil_moisture_0_to_100cm | m³/m³ | 0-100厘米土壤体积含水量 |
| soil_moisture_index_0_to_7cm | - | 0-7厘米土壤湿度指数，反映土壤水分的相对多少，使用土壤体积含水量，田间持水量，萎蔫点计算，0表示极干，1表示最湿，>1表示过湿（比如刚下过雨），可近似理解为土壤相对湿度 |
| soil_moisture_index_7_to_28cm | - | 7-28厘米土壤湿度指数 |
| soil_moisture_index_28_to_100cm | - | 28-100厘米土壤湿度指数 |
| soil_moisture_index_100_to_255cm | - | 100-255厘米土壤湿度指数 |
| soil_moisture_index_0_to_100cm | - | 0-100厘米土壤湿度指数 |
| 风类 | ||
| wind_speed_10m | m/s | 10米风速 |
| wind_speed_100m | m/s | 100米风速 |
| wind_direction_10m | ° | 10米风向 |
| wind_direction_100m | ° | 100米风向 |
| wind_gusts_10m | m/s | 10米阵风 |
| 降水/积雪类 | ||
| precipitation | mm | 降水量 |
| rain | mm | 降雨量 |
| showers | mm | 阵雨量 |
| snowfall | cm | 降雪量 |
| snowfall_water_equivalent | mm | 降雪水当量 |
| snow_depth | m | 积雪深度 |
| 云类 | ||
| cloud_cover | % | 总云量 |
| cloud_cover_low | % | 低云量 |
| cloud_cover_mid | % | 中云量 |
| cloud_cover_high | % | 高云量 |
| 辐射类 | ||
| shortwave_radiation | W/m² | 短波辐射 |
| shortwave_radiation_instant | W/m² | 瞬时短波辐射 |
| direct_radiation | W/m² | 直接辐射 |
| direct_radiation_instant | W/m² | 瞬时直接辐射 |
| direct_normal_irradiance | W/m² | 直接法线辐照度 |
| direct_normal_irradiance_instant | W/m² | 瞬时直接法线辐照度 |
| diffuse_radiation | W/m² | 散射辐射 |
| diffuse_radiation_instant | W/m² | 瞬时散射辐射 |
| terrestrial_radiation | W/m² | 地球辐射 |
| terrestrial_radiation_instant | W/m² | 瞬时地球辐射 |
| global_tilted_irradiance | W/m² | 倾斜辐照度 |
| global_tilted_irradiance_instant | W/m² | 瞬时倾斜辐照度 |
| 气压类 | ||
| pressure_msl | hPa | 海平面气压 |
| surface_pressure | hPa | 地表气压 |
| 其他要素 | ||
| boundary_layer_height | m | 边界层高度 |
| sunshine_duration | s | 日照时长 |
| et0_fao_evapotranspiration | mm | FAO参考作物蒸散发 |
| weather_code | - | 天气代码，WMO规定标准天气代码 |
| growing_degree_days_base_0_limit_50 | - | 生长度日 |
| leaf_wetness_probability | % | 叶片湿润概率 |
ERA5气压层数据
ERA5_pressure提供以下37个标准等压面的数据：
1000 hPa、975 hPa、950 hPa、925 hPa、900 hPa、875 hPa、850 hPa、825 hPa、800 hPa、775 hPa、750 hPa、725 hPa、700 hPa、650 hPa、600 hPa、550 hPa、500 hPa、450 hPa、400 hPa、350 hPa、300 hPa、250 hPa、225 hPa、200 hPa、175 hPa、150 hPa、125 hPa、100 hPa、70 hPa、50 hPa、30 hPa、20 hPa、10 hPa、7 hPa、5 hPa、3 hPa、2 hPa、1 hPa
每个等压面都支持以下要素：
基本气象要素
| 名称 | 单位 | 说明 |
|---|---|---|
| temperature | °C | 温度 |
| geopotential_height | m | 位势高度 |
| relative_humidity | % | 相对湿度 |
| wind_speed | m/s | 风速 |
| wind_direction | ° | 风向 |
| dew_point | °C | 露点温度 |
| cloud_cover | % | 云量 |
| vertical_velocity | m/s | 垂直速度（正值表示上升，负值表示下沉） |
注：等压面变量需与具体气压层（如 temperature_850hPa）结合使用。