德国气象局 (ICON)
德国气象局ICOsahedral Nonhydrostatic数值天气预报模式数据
基本信息
| 项目 | 详情 |
|---|---|
| 模型名称 | ICON |
| 来源 | 德国气象局 |
| 空间分辨率 | 11km |
| 原始时间分辨率 | 1小时 |
| 预测时长 | 7天 |
| 更新频率 | 每6小时 |
使用示例
https://api.mirror-earth.com/v1/forecast?latitude=39.9&longitude=116.4&hourly=temperature_2m&timezone=auto&models=icon&forecast_days=7&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 | 填icon |
| timezone选填 | string | 时区，默认为世界时，auto表示根据经度自动计算全部时区：时区列表 |
支持的要素
地面要素
| 名称 | 单位 | 说明 |
|---|---|---|
| 温度类 | ||
| temperature_2m | °C | 2米气温 |
| temperature_80m | °C | 80米气温 |
| temperature_120m | °C | 120米气温 |
| temperature_180m | °C | 180米气温 |
| apparent_temperature | °C | 体感温度 |
| dew_point_2m | °C | 2米露点温度 |
| wet_bulb_temperature_2m | °C | 2米湿球温度 |
| 湿度类 | ||
| relative_humidity_2m | % | 2米相对湿度 |
| vapour_pressure_deficit | hPa | 饱和水汽压差 |
| 风类 | ||
| wind_speed_10m | m/s | 10米风速 |
| wind_direction_10m | ° | 10米风向 |
| wind_speed_80m | m/s | 80米风速 |
| wind_direction_80m | ° | 80米风向 |
| wind_speed_120m | m/s | 120米风速 |
| wind_direction_120m | ° | 120米风向 |
| wind_speed_180m | m/s | 180米风速 |
| wind_direction_180m | ° | 180米风向 |
| wind_gusts_10m | m/s | 10米阵风 |
| 降水/积雪类 | ||
| precipitation | mm | 降水量 |
| showers | mm | 对流降水量 |
| rain | mm | 大尺度降雨量 |
| snowfall | cm | 降雪量 |
| snowfall_water_equivalent | mm | 降雪水当量 |
| snow_depth | m | 积雪深度 |
| snowfall_height | m | 降雪高度 |
| 云类 | ||
| cloud_cover | % | 总云量 |
| cloud_cover_low | % | 低云量 |
| cloud_cover_mid | % | 中云量 |
| cloud_cover_high | % | 高云量 |
| convective_cloud_top | m | 对流云顶高度 |
| convective_cloud_base | m | 对流云底高度 |
| 辐射类 | ||
| 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² | 瞬时散射辐射 |
| global_tilted_irradiance | W/m² | 倾斜辐照度 |
| global_tilted_irradiance_instant | W/m² | 瞬时倾斜辐照度 |
| terrestrial_radiation | W/m² | 地球辐射 |
| terrestrial_radiation_instant | W/m² | 地球瞬时辐射 |
| 气压类 | ||
| pressure_msl | hPa | 海平面气压 |
| surface_pressure | hPa | 地表气压 |
| 土壤类 | ||
| soil_temperature_0cm | °C | 0厘米土壤温度 |
| soil_temperature_6cm | °C | 6厘米土壤温度 |
| soil_temperature_18cm | °C | 18厘米土壤温度 |
| soil_temperature_54cm | °C | 54厘米土壤温度 |
| soil_moisture_0_to_1cm | m³/m³ | 0-1厘米土壤湿度 |
| soil_moisture_1_to_3cm | m³/m³ | 1-3厘米土壤湿度 |
| soil_moisture_3_to_9cm | m³/m³ | 3-9厘米土壤湿度 |
| soil_moisture_9_to_27cm | m³/m³ | 9-27厘米土壤湿度 |
| soil_moisture_27_to_81cm | m³/m³ | 27-81厘米土壤湿度 |
| 对流/大气稳定度类 | ||
| cape | J/kg | 对流有效位能 |
| lightning_potential | - | 闪电潜势指数 |
| updraft | m/s | 最大上升气流 |
| convective_cloud_top | m | 对流云顶高度 |
| convective_cloud_base | m | 对流云底高度 |
| 能量/热通量类 | ||
| sensible_heat_flux | W/m² | 感热通量 |
| latent_heat_flux | W/m² | 潜热通量 |
| 其他要素 | ||
| weather_code | - | 天气代码 |
| is_day | - | 是否白天 |
| sunshine_duration | s | 日照时长 |
| freezing_level_height | m | 冻结层高度 |
| visibility | m | 能见度 |
等压面要素
支持以下等压面（30, 50, 70, 100, 150, 200, 250, 300, 400, 500, 600, 700, 800, 850, 900, 925, 950, 1000 hPa）：
| 名称 | 单位 | 说明 |
|---|---|---|
| temperature | °C | 温度 |
| dew_point | °C | 露点温度 |
| relative_humidity | % | 相对湿度 |
| wind_speed | m/s | 风速 |
| wind_direction | ° | 风向 |
| geopotential_height | m | 位势高度 |
注：等压面变量需与具体气压层（如 temperature_850hPa）结合使用。