数据要素全量目录

本页是运梦气象平台底层全量数据要素目录，覆盖平台底层可获取的完整气象、辐射、土壤与农业要素，供高级与定制化场景查阅选型。

与 API 字段口径的关系：downloadSync 接口当前对外稳定暴露的是其中的 CF 标准字段子集——tas、hurs、sp、pr、uas、vas、ws、wd、rsds、dni、dhi、u100、v100、u10n、v10n（详见 API 参考）。下表中的底层字段按场景按需开放，接入前请以 /api-specs/weather-v1.yaml 与 API 参考 的字段枚举为准。

注意：列表中的单位（如 °C、mm）通常是经过后处理转换后的单位，更符合使用习惯。

1. 常规气象要素 (Common)

参数名称单位说明
temperature_2m°C距地面 2 米高度处的空气温度，是日常天气预报最核心、人体感受最直接的环境温度指标。陆地常年取值约 -4050°C，我国大部分地区年内多在 -2040°C 区间。该要素直接驱动建筑/工业冷热负荷与电网空调负荷预测，是电力日前/实时负荷预测与电力交易需求侧建模的关键输入，也是光伏组件工作温度修正、农业积温与霜冻评估的基础变量。
apparent_temperature°C综合气温、相对湿度、风速与辐射等因子计算的人体实际感受温度：夏季高湿时高于实际气温（闷热），冬季有风时低于实际气温（风寒）。通常与实际气温偏差在 ±10°C 以内，极端湿热或大风严寒下偏差可超过 15°C。主要用于电力降温/取暖负荷的体感修正、高温热浪与寒潮期间的尖峰负荷预警，以及户外作业、农业与公共健康的舒适度与风险评估。
wet_bulb_temperature_2m°C当前温湿条件下空气经蒸发冷却所能达到的最低温度，恒不高于干球气温，二者之差反映空气干燥程度。常见取值多在 -5~30°C，湿球温度超过 35°C 时人体已无法靠出汗散热（致命阈值）。在新能源与电力场景中是火电、核电及数据中心湿式冷却塔出水温度与冷却效率的理论下限，直接影响夏季机组出力降额与电网供给能力，也用于蒸发冷却可行性与高温高湿停工阈值判定。
dew_point_2m°C空气中水汽达到饱和、开始凝结成液态水时的温度，是大气绝对水汽含量的直接度量。露点恒不高于气温，常年取值约 -3028°C，露点越高空气越潮湿；气温接近露点（温度露点差小于 23°C）时易生成雾、露、霜。用于光伏组件结露/积灰清洗时机判断、输电线路与变电设备凝露闪络风险评估、夜间辐射降温预测，以及大雾导致的光伏出力骤降与可见度安全分析。
wind_speed_10mm/s距地面 10 米标准气象观测高度的平均风速，1 m/s≈3.6 km/h；通常 34 m/s 为微风、810 m/s 为大风、17 m/s 以上达大风/8 级。它是地面风资源评估与小型/分布式风机出力的基准量，也是输电线路风荷载、光伏支架抗风设计、火灾蔓延与污染扩散评估的核心参数，并通过强迫对流影响光伏组件散热与发电温度修正。
wind_speed_100mm/s距地面约 100 米（接近现代风机轮毂高度）的平均风速，因地表摩擦随高度衰减，通常较 10 米风速大 2030%，良好风场年均可达 69 m/s。该高度风速近似立方关系决定风电机组功率（一般 3 m/s 切入、12~15 m/s 达额定、25 m/s 切出），是风电场宏观选址、发电量评估与日前/超短期风功率预测的首要驱动量，也用于高层与高耸结构的风荷载设计。
wind_direction_10m°地面 10 米高度风的来向，以正北为 0°、顺时针计量，90°为东风、180°为南风、270°为西风。用于风电场尾流与机位排布优化、污染物与火灾烟羽扩散路径预测、机场与桥梁等工程的侧风评估，以及结合风速判别冷暖平流对气温与负荷的影响。
wind_direction_100m°轮毂高度附近风的来向，定义与地面风向一致；受地表摩擦影响小，方向较近地面更稳定且常存在随高度顺转的风切变。是风电机组偏航控制与机组朝向、风场尾流损失计算和主导风向（风玫瑰）分析的关键输入，直接关系风电场整体发电效率与机位布局。
wind_gusts_10mm/s短时（通常 23 秒）出现的最大瞬时风速，恒大于同期平均风速，阵风系数一般为平均风速的 1.32.0 倍，强对流下可达 30 m/s 以上。它是风电机组载荷校核、超额定阵风触发停机保护的判据，也是输电杆塔与光伏阵列抗风设计、塔吊与高空作业安全管控、防风减灾预警的关键指标。
pressure_mslhPa将台站实测气压按标准大气订正到海平面后的气压值，消除海拔差异以便区域间天气系统比较，标准海平面气压为 1013.25 hPa，常年多在 980~1040 hPa 波动。是识别高低压系统、锋面与台风（中心可低于 950 hPa）的核心要素，用于大尺度风场与天气过程预报，从而支撑风光功率预测与电网灾害性天气预警。
surface_pressurehPa台站所在海拔处的实际大气压力，随海拔升高而降低，近地面每升高约 10 米下降约 1 hPa，高原地区可低至 600~800 hPa。它决定空气密度，直接影响风电机组实际出力（密度随气压正比变化）、燃机与冷却设备效率，以及光伏组件与电气设备的散热和气体绝缘耐压设计。

2. 降水要素 (Precipitation)

参数名称单位说明
precipitationmm单位时间内到达地面的液态与固态降水总量（含雨、雪、冰雹、霰等所有形态，固态部分折算为等效液态水深），1mm 即每平方米地面积水 1 升。我国年降水量南方多在 1000–2000mm、华北约 400–600mm、西北干旱区不足 200mm，单次中雨小时强度约 2.5–8mm/h、暴雨可达 16mm/h 以上。是光伏组件冲刷自清洁与积灰恢复评估、地面/水面电站排水与防涝设计、风电场道路通行与吊装窗口判断、以及电网防汛和负荷预测（雨天空调与照明负荷变化）的核心输入。
rainmm仅统计液态降水量，剔除降雪、冰雹等固态成分，反映真正落到地面的雨水深度。毛毛雨小时量级约 0.1–0.5mm/h，一般阵性降雨 1–4mm/h，强降雨可超过 10mm/h，单日大雨多在 25–50mm。用于光伏阵列雨水清洗效果与发电恢复量估算、电站及升压站雨水管网容量校核、风机基础和集电线路的地表径流防护，农业上结合土壤墒情指导灌溉调度与排涝。
showersmm由对流云团造成的短历时、高强度阵性降水，空间分布零散、开始与结束突然，常与雷暴、强风及辐照骤降相伴。单次过程多持续十几分钟至 1 小时，瞬时强度可达 10–30mm/h 甚至更高。对光伏出力预测意义突出——阵雨来临前后辐照可在分钟级内大幅起落，是分布式光伏功率陡变（爬坡事件）与电网调频备用、现货电力交易日内偏差控制的重要预警量，也用于户外施工与吊装作业的临时避险决策。
snowfallcm单位时间内新增的积雪厚度（以雪面物理厚度计，而非折算水量），因新雪疏松、密度低，同等水量下其厚度数值远大于降雨毫米数。小雪日量级约 0.1–2.5cm，中雪 2.5–5cm，大雪 5–10cm，暴雪可超 10cm。直接影响光伏组件积雪遮挡与发电骤减、组件与支架的雪荷载安全（设计需按当地基本雪压校核）、风机叶片覆冰与停机风险，并关系到电网冬季采暖负荷激增与道路除雪后的运维通达性。
snowfall_water_equivalentmm将新降雪完全融化后得到的等效液态水深，消除了雪密度差异，便于与雨量在同一量纲下统计和水量平衡核算。新雪典型雪水比约 10:1（即 10cm 新雪 ≈ 10mm 水当量），干冷蓬松雪可达 15:1–20:1，湿重雪则低至 5:1 左右。用于跨形态降水的统一水文统计、流域产汇流与水电来水预报、土壤春季融雪补水评估，以及通过密度反推雪荷载、辅助光伏与风电结构的覆雪承载分析。
snow_depthm地面当前实际积存的积雪总厚度，是历史降雪逐日累积、压实、消融与升华共同作用的结果，反映存量而非单次增量。平原地区季节性积雪多在 0.05–0.5m，东北及高山雪区可达 1m 以上。直接决定光伏阵列被掩埋遮挡的持续天数与发电损失、组件支架的累积雪压安全裕度、地面电站离地高度与倾角设计，并用于风电场冬季道路与场区可达性、电网融雪期防汛及山区线路覆雪舞动风险研判。

3. 云类要素 (Clouds)

参数名称单位说明
cloud_cover%总云量，指天空被各高度层云体遮蔽的总比例，0% 为万里无云、100% 为完全阴天，气象上也常用“成”（八分量）表述（如 50% 约对应 4 成云）。它是太阳到达地面辐射的首要衰减因子：薄云下地表辐射可降至晴空值的 60%–80%，厚积雨云下可骤降到 10%–20%，同时云顶夜间逆辐射会减小气温日较差。在光伏场景中总云量与组件出力高度负相关，是分钟级到日前功率预测、辐照度反演及电网调度备用容量测算的核心输入；在电力交易中云团移动导致的辐照突变直接决定光伏出力的爬坡风险与现货价格波动。
cloud_cover_low%低云量，指云底高度约 2 公里（2000 m）以下的低空云覆盖比例，主要为层云、雾、层积云及对流旺盛的积云/积雨云，水滴含量高、光学厚度大。低云对短波辐射的遮挡最强，整层云体往往使直接辐射几乎归零、仅余散射分量，是造成光伏出力急剧塌陷和短时大幅波动的主因，典型多云天其值可在数分钟内于 20%–90% 间跳变。在新能源功率预测、风光场区辐照短时外推及调度实时平衡中，低云量是判别“晴/多云/阴”工况和触发备用调用的关键变量；在农业上低云与雾还关系到作物受光时数与病害湿度条件。
cloud_cover_mid%中云量，指云底高度约 2–6 公里中空层的云覆盖比例，主要为高积云、高层云，多由过冷水滴与冰晶混合组成，光学厚度介于高、低云之间。中云对辐射的衰减为中等强度：成片高层云常使地面总辐射降到晴空的 40%–70%，并往往预示天气系统（锋面、降水）的临近，其出现频率在 20%–60% 区间较为常见。在光伏与电网应用中，中云量用于精细化辐照分量（直射/散射）分解与日内功率滚动预测，辅助识别由天气系统过境引发的出力趋势性下降；在工程与农业气象中则用于评估光照条件与降水前兆。
cloud_cover_high%高云量，指云底高度约 6 公里（6000 m）以上、由冰晶构成的高空云覆盖比例，主要为卷云、卷积云、卷层云，通常云体薄、透光性好。高云对太阳辐射的削减相对温和，半透明卷云一般仅使地面总辐射下降 10%–30%，且更多表现为将直接辐射转化为散射辐射，对光伏的影响以缓变而非骤降为主；卷层云增厚常是暖锋来临、未来 12–24 小时转阴雨的征兆。在新能源预测中，高云量用于修正晴空辐照模型的散射占比、提升日前/日内辐照预报精度，并作为天气系统提前预警的参考；在航空与工程气象中亦用于能见度与光照环境评估。

4. 辐射要素 (Radiation)

参数名称单位说明
shortwave_radiationW/m²到达水平地面的全波段太阳短波辐射总量(波长 0.3–3 微米)，等价于水平面总辐照度 GHI，由直接辐射与散射辐射叠加而成。晴天正午约 800–1000 W/m²，强对流或薄云增强时瞬时可破 1200 W/m²，夜间为 0；通常指过去一小时的平均值。它是光伏发电的第一驱动量，直接决定固定式与跟踪式电站的理论出力，光伏功率预测、容配比设计、电网新能源消纳与现货交易申报曲线均以其为输入。
shortwave_radiation_instantW/m²报文时刻的瞬时水平面总辐照度，不做时段平均，随太阳高度角的日变化与云团遮挡逐分钟剧烈波动。晴空时呈平滑的钟形日曲线(正午峰值约 900 W/m²)，积云过境时可在数十秒内骤降至 200 W/m² 以下再回弹。用于光伏逆变器实时建模、超短期(15 分钟级)功率预测、爬坡事件识别与储能平滑控制，比小时均值更能刻画功率的瞬时跌落风险。
direct_radiationW/m²投射到水平地面、未被大气分子与气溶胶散射的太阳直射分量(即水平面直接辐照度 BHI)，等于 DNI 乘以太阳天顶角余弦。晴朗干燥天气下可占总辐射的 70–80%(正午约 600–800 W/m²)，雾霾或厚云时趋近于 0。它是单轴/双轴跟踪光伏与聚光系统增益评估的核心，跟踪支架相对固定支架的发电增益主要来源于对该分量的高效捕获。
direct_radiation_instantW/m²报文时刻的瞬时水平面直接辐照度，对云的响应最为敏感，云层一旦遮挡太阳圆面便几乎瞬间归零，云隙再现时又快速恢复。晴空瞬时值正午可达 700 W/m² 量级，多云天则在 0 与数百 W/m² 间高频跳变。用于跟踪系统实时寻日策略、聚光镜场瞬时热负荷计算，以及识别由云遮造成的电站出力骤降。
direct_normal_irradianceW/m²直接法线辐照度(DNI)，指在垂直于太阳光线的平面上接收到的直射辐照度，剔除了天顶角投影的几何衰减，反映大气对太阳光束的真实透过能力。优良直射资源地区晴天正午约 900–1000 W/m²，干旱高海拔地区可逼近 1050 W/m²，阴天接近 0。它是塔式/槽式聚光太阳能(CSP)与双轴跟踪光伏的决定性资源指标，用于镜场规模、储热时长与年发电量评估及选址打分。
direct_normal_irradiance_instantW/m²报文时刻垂直于太阳光线方向的瞬时直射辐照度，是聚光系统瞬时聚焦能量与吸热器热流密度的直接来源。晴空瞬时值正午约 950 W/m²，因其完全由直射构成，对云遮的敏感度高于任何其他辐射量，云过境时近乎阶跃式跌落。用于 CSP 吸热器防过温/防爆管保护、镜场实时调焦与聚光光伏(CPV)瞬时出力建模。
diffuse_radiationW/m²散射辐射(水平面散射辐照度 DHI)，指太阳光经大气分子瑞利散射、云滴与气溶胶散射后从天穹各方向到达水平地面的辐射，方向性弱。晴天约占总辐射 15–25%(正午约 100–150 W/m²)，全阴天几乎是唯一光照来源(可达 100–300 W/m²)。它是固定式光伏在阴天仍能出力的物理基础，也是双面组件背面增益与建筑光伏(BIPV)弱光性能评估的关键输入。
diffuse_radiation_instantW/m²报文时刻的瞬时水平面散射辐照度，因来自整个天空半球，时间波动远比直射分量平缓。晴空瞬时值约百余 W/m²，云量增多时反而上升，破碎积云的边缘散射甚至可使其短时增大。用于阴天与晨昏弱光时段的逆变器实时建模、双面组件瞬时背面辐照估算，以及辐射分量分离算法的校验。
terrestrial_radiationW/m²地表向上空发射的长波热红外辐射(波长 4–50 微米)，遵循斯特藩-玻尔兹曼定律随地表温度四次方变化，与短波太阳辐射属不同波段。地球表面典型量级约 300–500 W/m²，地表越热数值越大。它是地表辐射收支与夜间辐射降温的核心项，用于光伏组件背板散热与工作温度(进而温度损失)评估、夜间结霜与作物冻害预警及建筑能耗负荷计算。
terrestrial_radiation_instantW/m²报文时刻地面发出的瞬时长波辐射强度，与短波辐射不同，它昼夜不停，夜间在无太阳输入时仍持续向外散热并主导地表降温。瞬时量级约 300–500 W/m²，日间随地表升温升高、清朗夜晚因热量快速散失而偏低。用于辐射霜冻的逐时预警、光伏组件夜间冷却与逆向温差(PID)分析，以及精细化地表能量平衡建模。
global_tilted_irradianceW/m²倾斜面总辐照度(GTI/POA)，指任意倾角与朝向平面(如最佳倾角组件、屋顶、坡地)接收到的太阳辐射总和，由倾斜面直射、各向异性天空散射与地面反射(反照率)三部分合成。在最佳倾角下其年累计值通常较水平面 GHI 高 10–25%，正午晴天可达 900–1100 W/m²。它是光伏组件实际进光量、即最贴近发电量的辐射指标，直接用于发电量精算、最佳倾角设计与系统效率(PR)核算。
global_tilted_irradiance_instantW/m²报文时刻倾斜组件平面的瞬时总辐照度，是逆变器实时直流输入功率的最直接驱动量，同时受瞬时云遮、太阳几何与地面反射影响。晴空瞬时峰值约千 W/m² 量级，云过境时随直射分量同步跌落。用于光伏电站超短期功率预测、单板/单串实时性能监测与异常诊断、MPPT 控制建模及现货市场实时申报曲线修正。

5. 农业与生物气象 (Other / Agriculture)

参数名称单位说明
et0_fao_evapotranspirationmmFAO 参考作物蒸散发，依据联合国粮农组织 Penman-Monteith 标准方程，以气温、相对湿度、风速、净辐射为输入，模拟高 0.12 m、表面阻力固定的标准草坪在充分供水下的潜在蒸散量。日累计值夏季晴热天约 5–8 mm/d，干旱区高温大风可达 10 mm/d 以上，冬季或阴雨天常低于 1–2 mm/d，年累计多在 700–1600 mm。农业上乘以作物系数 Kc 即得实际需水量，用于精准灌溉排程、水库与渠系调度；新能源场景中作为干热程度的综合代理，辅助评估光伏组件积灰频率与冲洗收益、以及生物质能源作物的产量与水耗权衡。
sunshine_durations日照时长，指直接辐射强度超过 120 W/m² 阈值的累计时间，即太阳未被云层显著遮挡、地面接收到清晰直射光的总秒数，等价于传统日照计读数。以日为周期，晴天可达 36000–43200 s（10–12 小时），多云天常降至 7200–18000 s（2–5 小时），阴雨天可接近 0。该指标直接决定光伏（尤其聚光 CSP 与跟踪式电站）的发电窗口与日发电量基准，是电站选址、出力曲线建模和容量系数估算的核心输入；农业上与作物光合积累、糖分形成、籽粒灌浆及晾晒作业密切相关。
vapour_pressure_deficithPa水汽压亏缺，为当前气温下饱和水汽压与实际水汽压之差，量化空气距离饱和的干燥程度，比相对湿度更直接反映植物的蒸腾拉力与水分胁迫。清晨高湿时趋近 0，多在 1–10 hPa 区间波动，午后干热高温条件下可升至 30–50 hPa。农业上是温室通风/喷雾控制和灌溉决策的关键变量（一般维持 4–12 hPa 利于作物生长），过高引发气孔关闭与减产；电力领域中高 VPD 标志极端干热，与空调负荷骤增、输电线路弧垂增大及山火风险上升相关，可纳入电网负荷预测与运行风险预警。
weather_code-天气代码，采用世界气象组织 WMO 4677 标准的离散数字编码描述瞬时天气现象，便于跨平台机器解析与图标映射。典型取值如 0=晴、1–3=少云至阴、45/48=雾、51–67=毛毛雨/雨/冻雨、71–77=降雪、80–82=阵雨、95–99=雷暴，数值越大通常代表天气越剧烈。在新能源调度中用于快速判别影响光伏/风电出力的天气类别（如雷暴、降雪覆盖触发出力骤降），驱动功率预测的工况分支与限电预案；农业生产用于喷药、收割、晾晒等田间作业的窗口安排与灾害性天气预警。
growing_degree_days_base_0_limit_50-生长度日（积温），以 0°C 为基础温度、50°C 为上限对日平均气温做截断后累加，量化作物可利用的有效热量积累，用于预测物候期与成熟进度。单日贡献通常为 0–30，作物全生育期累计依品种可达 1000–3000：例如冬小麦约 2000–2500，玉米约 2500–3000。农业上据此推算播种、抽穗、灌浆、收获等关键节点和病虫害世代发育，指导排期与农事；在生物质/能源作物及农光互补项目中，用于估算产量潜力、规划收储节奏与跨年度产能预测。
leaf_wetness_probability%叶片湿润概率，估计因降雨、露水或雾凝结导致植物叶面存在液态水膜的可能性，是真菌与细菌性病害侵染的关键诱因。取值 0–100%，晴朗干燥午后多接近 0，夜间至清晨露水期及降雨/浓雾时段常升至 70–100%。农业上据此预测霜霉病、白粉病、稻瘟病等病害爆发风险并优化喷药时机（叶面湿润时段不宜喷洒、易稀释药液降低药效），是病害预警模型与智慧植保的核心因子；在农光互补与设施农业场景中辅助通风除湿调控，间接降低病害损失与用药成本。

6. 土壤温度 (Soil Temperature)

参数名称单位说明
soil_temperature_0_to_7cm°C地表至地下 7 厘米深度的土壤平均温度，是受太阳辐射和气温驱动、日变化最剧烈的浅表层热状态指标，直接决定种子萌发、幼苗出土与表层微生物及硝化反应活性。该层日内波动可达 10–20 °C，夏季晴天午后裸地可升至 30–40 °C，冬季夜间或积雪覆盖下可降至 0 °C 以下；多数作物种子在 10–15 °C 以上开始稳定发芽。在农业场景用于排播种期、预测出苗率和指导地膜/灌溉降温；在新能源场景可辅助评估地面光伏阵列下方土壤热环境与组件背板散热条件。
soil_temperature_7_to_28cm°C7–28 厘米深度的土壤温度，对应大多数一年生作物的主要根系活动层，日变化已被显著削弱、滞后于地表数小时，主要反映季节性热量积累。典型取值随季节在约 0–30 °C 间变化，生长季多处于 12–28 °C，是根系吸水吸肥、土壤有机质矿化与养分释放速率的关键控制因子。农业上用于诊断根区适宜度、指导追肥与灌溉时机；在工程与电网侧，该深度接近浅埋电缆/接地体所在层，可用于估算地下电缆载流量降额和接地散热条件。
soil_temperature_28_to_100cm°C28–100 厘米深度的土壤温度，几乎无日变化、季节波动幅度也明显减小（通常年内在约 5–25 °C 区间），相位较地表滞后数周，代表中深层土壤的热储状态。该层温度影响深根作物（如果树、牧草、部分大田作物）的越冬与返青、地下水入渗温度及土壤热惯量。可用于灌区水温与冻土深度评估、农田越冬管理，以及浅层地源热泵换热效率和地埋管换热量的初步估算。
soil_temperature_100_to_255cm°C100–255 厘米深度的土壤温度，基本不受昼夜影响，年振幅很小且相位滞后地表可达 1–3 个月，常年稳定在当地年平均气温附近（多数温带地区约 8–18 °C），是近地表“恒温层”的代表。该层主要决定深层根系作物和木本植物的根区热环境与地下水基础温度。在新能源场景是地源热泵、地埋管地温能利用最重要的设计参数之一，稳定温度可直接换算冬季供暖/夏季制冷的可取热（冷）量与系统能效比 COP。
soil_temperature_0_to_100cm°C0–100 厘米整层土壤的体积加权平均温度，综合了浅表强波动层与中深稳定层，代表绝大多数农作物根系分布区的总体热状况，季节变化平缓、生长季多在约 10–28 °C。它平滑了地表噪声、又比单一深层更贴合实际根系吸热，常作为作物模型的根区温度输入与农业气象预警的核心指标。可用于评估积温进程、作物长势与产量潜力、灌溉与施肥调度，并为地面光伏电站场区土壤热环境监测提供整层基准。

7. 土壤湿度 (Soil Moisture)

参数名称单位说明
soil_moisture_0_to_7cmm³/m³0-7 厘米表层土壤的体积含水量，即单位体积土壤中液态水所占的体积分数，是对降水、灌溉、蒸发和地表蒸腾响应最快的层位。典型取值范围约 0.05（砂质干旱）至 0.45（饱和）m³/m³，多数耕作土壤适宜区间在 0.15–0.35 之间，凋萎点附近约 0.10。该层直接决定种子吸胀发芽与幼苗出土，在精准灌溉调度、播种窗口判定及地表起尘/扬沙预警中作为核心输入；对地面光伏，表层过湿易致组件支架基础积水与近地面湿度抬升，间接影响清洗与积灰评估。
soil_moisture_7_to_28cmm³/m³7-28 厘米浅层土壤的体积含水量，是小麦、玉米、蔬菜等多数大田作物根系最活跃、吸水最集中的层段，水分变化较表层平缓。常见区间约 0.12–0.40 m³/m³，田间持水量一般落在 0.25–0.35，低于约 0.15 即进入水分胁迫。该层是农业灌溉决策与作物需水预测的主要依据，可用于估算根区有效水分储量、安排灌水定额与轮灌周期；在农光互补电站规划中，可结合该层墒情评估光伏阵列下方种植可行性与遮阴对作物的水热影响。
soil_moisture_28_to_100cmm³/m³28-100 厘米深层土壤的体积含水量，是深根作物（如成熟期玉米、果树、牧草）的重要水分来源，也是表层缺水时的“缓冲水库”，对短期天气波动响应迟缓、惯性强。典型区间约 0.15–0.40 m³/m³，反映中长期降水累积与灌溉下渗状况。该层用于评估农田深层储水、判断作物抗旱能力与是否需要深灌补墒，并为流域水文与地下水补给估算提供边界条件；其季节性变化也是中长期干旱演变监测的关键指标。
soil_moisture_100_to_255cmm³/m³100-255 厘米最深层土壤的体积含水量，水分变化极为缓慢，主要由季节乃至年际尺度的降水盈亏与深层下渗驱动，是连接土壤水与地下水的过渡带。取值通常在 0.15–0.40 m³/m³，长期偏离反映持续性湿润或干旱背景。该层在旱季与连续亏水时尤为关键，决定深根植被和多年生作物能否维持存活；在长期农业水资源规划、抗旱储备评估、地下水补给与流域水量平衡分析中作为底层约束，对水电站来水的中长期趋势研判也具参考价值。
soil_moisture_0_to_100cmm³/m³0-100 厘米主根系层的整层平均体积含水量，是对前述分层的综合表征，代表作物可利用水分的整体储量与农田总体墒情。数值多在 0.15–0.40 m³/m³，是衡量区域旱涝状态最常用的综合墒情指标之一。该字段广泛用于农业干旱监测预警、灌溉总量调控、作物长势与产量预测建模；在新能源侧，可作为区域气候湿润度与生物质蒸腾负荷的代理变量，辅助电网负荷（尤其农业排灌用电）需求侧预测，并为农光互补、生态光伏项目的土地适宜性评估提供综合水分本底。

8. 土壤湿度指数 (Soil Moisture Index)

参数名称单位说明
soil_moisture_index_0_to_7cm-0-7 厘米表层土壤湿度指数，将体积含水量按萎蔫点与田间持水量两个特征点做归一化：0 表示土壤水分降至萎蔫点（作物无法吸水的极度干旱），1 表示达到田间持水量（重力排水后保持的理想湿润状态），>1 表示孔隙过饱和或地表积水。该层直接控制裸土蒸发和种子发芽，典型取值在干旱季可低至 0.1–0.2、降雨后短时升至 0.9–1.1，因消去了土壤质地差异而可跨地块横向比较。农业上用于判定播种墒情、灌溉启停与喷洒/施肥作业窗口；光伏电站可据此评估地表扬尘与组件积灰倾向、辅助安排清洗。
soil_moisture_index_7_to_28cm-7-28 厘米浅根区土壤湿度指数，归一化口径与表层一致（0=萎蔫点，1=田间持水量，>1=过湿），但因深度较大、响应较表层滞后且波动平缓，单次降雨后通常在 0.4–0.8 区间缓变。该层覆盖小麦、玉米、蔬菜等多数作物的主要吸水根系，是评估短期旱情和精准灌溉量的核心层；对工程与电力场景，可用于判断浅基础、电杆与接地极周边土壤的承载力及湿陷/冻胀风险。
soil_moisture_index_28_to_100cm-28-100 厘米深根/底墒层土壤湿度指数，归一化口径同上，蓄水量大、惯性强，常年多在 0.3–0.7 间缓慢演变，是判断中长期干旱（伏旱、冬春连旱）和地下水补给的关键指标。农业上反映深根作物与果树的可持续供水能力及土壤底墒储备；在新能源与电网场景，可服务于地埋电缆散热环境评估、地源热泵换热效率以及流域来水与水电出力的中期预判。
soil_moisture_index_100_to_255cm-100-255 厘米深层土壤湿度指数，归一化口径同上，处于根系活动末端、近地下水波动带，数值变化极为迟缓，通常长期稳定在 0.3–0.6，主要反映年际尺度的水分盈亏与深层蓄水状态。可用于流域水文与地下水补给的长周期监测、大型深基础与桩基的长期工程稳定性评估，以及水电、抽水蓄能等对季节性蓄水高度敏感场景的中长期资源研判。
soil_moisture_index_0_to_100cm-0-100 厘米综合根系层土壤湿度指数，是对上述各分层在 1 米深度内的加权汇总，代表整体根系层的干湿状况，归一化口径同上（0=萎蔫点，1=田间持水量，>1=过湿），常态值多在 0.3–0.8。它平滑了表层的剧烈波动、又比单一深层更贴近作物实际可用水，是区域旱情等级、综合墒情监测与灌溉决策最常用的单一指标；在新能源侧可用于农光互补项目的种植适宜性评估、电站场地排水与基础工况判断，以及结合降水预报对农业用水—电力调度耦合需求的统筹分析。