气象数据概念
解释观测、再分析、实时预报和历史预报的区别，帮助选择数据产品。
历史数据
历史数据描述已经发生的天气，主要来自观测资料与再分析资料。再分析数据将多种观测与数值模式结合，具有连续的空间覆盖，适合长期分析和模型训练。
Mirror Earth 的历史数据接口主要提供 ERA5 和 ERA5 等压面数据。具体变量与时间范围请查看历史数据 API及历史数据源目录。
实时预报
实时预报由数值天气预报模式或 AI 预报模型计算得到，描述未来可能发生的天气。预报存在不确定性，距离当前时间越远，不确定性通常越大。
可用模型和变量请查看实时预报 API。
历史预报
历史预报保存模型在过去各个起报时刻生成的预报结果。它与历史实际天气不同，适合评估预报误差、比较模型和复盘天气事件。
使用时需要提供模型的起报时间，详见历史预报数据 API。
无缝数据
无缝数据把历史再分析与未来预报连接成一条时间序列。它适合需要连续输入数据的业务，避免在历史数据和预报数据之间手动切换。
详见无缝数据 API。
站点观测
ERA5 等再分析数据是覆盖全球的网格产品，不是气象站的原始观测记录。同一地点的再分析值与附近气象站的官方观测会存在差异，在山区、沿海和城市中尤其明显。需要官方站点记录时，请以气象部门发布的数据为准。
网格与坐标
数值模式和再分析数据以网格存储。按经纬度查询时，接口返回距离请求坐标最近的格点，响应中的 latitude、longitude 是实际取值格点的坐标，不是请求坐标。
| 参数 | 作用 |
|---|---|
cell_selection | 格点选择方式：land（默认，优先陆地格点）、sea（优先海上格点）、nearest（最近格点） |
elevation | 指定海拔（米），用于温度等变量的高程订正；不传时使用地形数据中的海拔 |
响应中的 elevation 为实际使用的海拔。风电、光伏场站和山区点位建议传入场站实际海拔。
行政区与区域平均
按行政区（adcode）批量下载时，area_average: true 表示对行政区边界内所有格点取空间平均，输出一行一个行政区的序列，代表的是整个行政区，而不是省会或某个城市的点值。详见批量下载区域平均数据。
时区与日界
- 不传
timezone时，time为 GMT（UTC）。 - 逐日变量按
timezone指定时区的自然日（00:00–24:00）统计。同一天在 UTC 和北京时间下的日最高温、日累计降水可能不同。 - 数据只更新到某一时刻时，查询区间最后一天可能缺少部分小时，该日的日值不完整。使用最新日期的日值前，请核对对应的逐小时数据。
- 历史预报的起报时间
init_time始终为 UTC。
瞬时值与累计值
| 类别 | 示例变量 | 含义 |
|---|---|---|
| 瞬时值 | temperature_2m、wind_speed_100m、relative_humidity_2m | 该时刻的状态 |
| 前一时段累计 | precipitation、rain、snowfall | 该时刻之前一个时间步（逐小时为前 1 小时）的累计量 |
| 前一时段平均 | shortwave_radiation、direct_normal_irradiance 等辐射变量 | 该时刻之前一个时间步的平均值 |
| 前一时段最大 | wind_gusts_10m | 该时刻之前一个时间步内的最大阵风 |
15 分钟输出时，原生步长更长的模型会插值到 15 分钟，各模型的原生步长见对应数据源页面。