快速开始
覆盖历史再分析与未来预报、15 类气象要素、全球任意经纬度的逐小时时间序列——一页看清能取到哪些数据、覆盖哪些要素、以什么方式下载。
数据源(4 个)
历史再分析提供稳定长序列,未来预报支撑短期决策;4 个数据源覆盖全球与中国区域。
ERA5 era5
逐小时、长序列、物理自洽的全球再分析数据,可回溯至约 1950 年,是资源评估与历史回测的稳定底座。
NASA nasa
提供历史气象数据,用于多源交叉验证与数据补充。
中国数源 V1.0 zg1
面向中国区域的历史再分析数据,本地化刻画更细。
德国气象局 ger
未来约 7 天数值预报,支撑短期功率预测、电力交易申报与户外作业排期。
气象要素(15 类)
字段采用 CMIP 风格标准命名,按温压湿降水、近地面风、轮毂高度风、太阳辐射四类组织;每个字段可按需单独勾选下载。
温度 · 湿度 · 气压 · 降水4 项
| 字段 | 名称 | 说明与典型用途 |
|---|---|---|
tas | 气温 | 近地面气温,影响光伏组件效率、电力负荷与作物生长。 |
hurs | 相对湿度 | 近地面相对湿度,关联结露、能见度与户外作业条件。 |
sp | 地面气压 | 地面气压,用于大气状态刻画与模型输入。 |
pr | 降水 | 降水量,关系作业窗口、防汛与农业灌溉决策。 |
近地面风(10m)6 项
| 字段 | 名称 | 说明与典型用途 |
|---|---|---|
uas | 近地面 U 风分量 | 10m 高度东西向(纬向)风分量。 |
vas | 近地面 V 风分量 | 10m 高度南北向(经向)风分量。 |
ws | 风速 | 10m 风速,风资源评估与作业安全的核心量。 |
wd | 风向 | 10m 风向,用于扇区分析与微观选址。 |
u10n | 中性 10m U 风分量 | 中性层结假设下的 10m 东西向风分量,便于跨数据源、跨场址对比。 |
v10n | 中性 10m V 风分量 | 中性层结假设下的 10m 南北向风分量。 |
轮毂高度风(100m)2 项
| 字段 | 名称 | 说明与典型用途 |
|---|---|---|
u100 | 100m U 风分量 | 约轮毂高度(100m)东西向风分量,风电功率预测的关键输入。 |
v100 | 100m V 风分量 | 约轮毂高度(100m)南北向风分量。 |
太阳辐射3 项
| 字段 | 名称 | 说明与典型用途 |
|---|---|---|
rsds | 水平总辐射(GHI) | 地表水平面接收的总(短波)辐射,光伏发电量测算的核心量。 |
dni | 法向直射辐射(DNI) | 垂直于太阳光线方向的直射辐射,聚光与跟踪式光伏所需。 |
dhi | 水平散射辐射(DHI) | 水平面上的散射辐射,复杂天气与阴雨条件下出力建模所需。 |
注:太阳辐射(GHI/DNI/DHI)服务光伏功率预测与资源评估;100m 风分量服务风电功率预测与微观选址;温湿压降水服务综合气象、户外作业与农业等场景。字段数值口径以接口文档(OpenAPI)为准。
覆盖与规格
空间覆盖
全球任意经纬度,按点位(lat / lon)精确取数。
时间分辨率
逐小时(hourly)时间序列,可按起止时间任意截取。
时间范围
历史源长序列(ERA5 可回溯至约 1950 年);预报源覆盖未来约 7 天。
返回形态
时间序列 JSON(timeList + 各要素数组),可直接喂入模型或绘图。
下载方式
单接口 POST /api/energy-weather/search/weather/action/downloadSync:按经纬度、起止时间、要素列表、数据源与时区提交一次请求,返回时间序列 JSON。
请求参数
lat/lon:纬度 / 经度。dataSourceId:数据源,取值era5/nasa/zg1/ger。stime/etime:起止时间,格式yyyy-MM-dd HH:mm:ss。fields:要素列表,从上述 15 类中按需勾选。timezone:时区偏移,例如8。
请求示例
{ "lat": 31.7655, "lon": 105.205, "dataSourceId": "era5", "stime": "2026-04-20 00:00:00", "etime": "2026-04-21 23:00:00", "fields": ["tas", "hurs", "ws"], "timezone": "8" }响应
统一 JSON 包:{ code, success, data: { timeList, tas, ... }, msg, errorCode }; success=false 不计费。鉴权、配额与计费由运梦控制台统一管理,匿名即可试用。
常见问题
运梦气象大数据 支持哪些数据源?
运梦气象大数据 提供 4 个数据源:era5(欧洲中期天气中心历史再分析)、nasa(美国历史气象数据)、zg1(国产区域历史再分析)、ger(德国气象局短期预报)。查询时在接口的 dataSourceId 参数中按取值 era5 / nasa / zg1 / ger 选择其一。
免登录试用有哪些限制?
无需注册即可试用:每日 5 次调用配额,按 IP + guestId 识别;请求携带 X-Guest-Id、无需 Bearer 即可调用 POST /api/energy-weather/search/weather/action/downloadSync。单次查询限单个点位,时间跨度不限(只需落在可查日期范围内)。
免登录可以查询哪些日期范围?
免费体验时段固定为 2025-06-01 至 2025-06-07 的历史数据,另可查今天至未来 3 天的预报(今 至 今+3)。正式账号可查询范围不受该时段限制;且在该免费时段内的查询登录后同样免费(每日 100 次),时段外按积分计费。
接口如何计费?返回失败会扣费吗?
正式账号在免费体验时段内的查询同样免费(每日 100 次),时段外按调用次数与字段数综合扣减积分;当返回 success=false(业务失败)时不扣费。免登录试用不消耗账户积分,仅占用每日 5 次配额。
气温、气压的单位是什么?时间如何表示?
气温 tas 默认以摄氏度 °C 返回,地面气压 sp 默认以 hPa 返回;起止时间 stime / etime 采用 yyyy-MM-dd HH:mm:ss 格式,可通过 timezone 参数指定时区(默认东八区)。
注册后能获得什么?
注册即获得一次性启动积分(不可提现,仅用于抵扣 API 调用),并可在控制台自助签发以 sk- 开头的 API Key,通过 Authorization: Bearer 请求头正式接入。
