中国区域数值模式预报网格区域裁切

WARMS 9 km 中国区域模式预报的区域裁切。按开通区域的经纬度边界裁出单个变量的 NetCDF，文件内包含该起报批次全部预报时效。source 取 warms9km。

数据说明

项	说明
数据来源	WARMS 9 km 中国区域模式预报
数据格式	NetCDF；一个变量一个文件，文件内含该批次全部已裁切的预报时效
元信息	文件内包含经纬度、step（单位小时）、valid_time 等必要元信息
起报时间	每日 00、12 时（UTC）
预报时效	最长 72 小时，逐小时
源网格	兰伯特等角圆锥投影，空间分辨率约 9 km
输出网格	重采样后的规则经纬度网格，坐标按 WGS84（EPSG:4326）使用，分辨率约 0.081°
模式覆盖范围	经纬度外接边界为 52.80186°E–157.19814°E、7.30506°N–59.84271°N；有效范围以 覆盖范围 GeoJSON 多边形为准
裁切范围	按开通区域的经纬度边界裁切；开通区域须落在模式覆盖范围内
产物保留	约 7 天，更早的起报批次可能已过期

支持变量

变量	变量说明
2t	近地面 2m 处的气温，单位 K
prate	降水率，单位 mm/h；预报时效从 step=1 开始，不包含 step=0

请求

GET https://singer.caiyunhub.com/v3/ud/cut/{area_id}

• 错误信息 | 数据说明

路径参数

参数	说明
area_id	区域 ID，由商务开通时提供，格式为 {客户缩写}_{编号}，如 demo_440300

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
source	是	—	warms9km	固定取 warms9km
variable	是	—	2t、prate	一次请求返回一个变量，见支持变量
base_time	否	最新起报	每日 00、12 时（UTC）	指定起报批次。格式为 ISO 8601 UTC 或 YYYYMMDDHH，如 2026102712

本接口不提供 step、hours 等预报时效过滤参数：预报时效在文件内的 step 维中，单个文件包含该变量该批次全部已裁切的 step。

请求示例

curl "https://singer.caiyunhub.com/v3/ud/cut/demo_440300?source=warms9km&variable=2t&base_time=2026102712&token={token}"

响应示例

{
  "source": "warms9km",
  "area_id": "demo_440300",
  "variable": "2t",
  "base_time": "2026-10-27T12:00:00Z",
  "url": "https://meteorology.caiyuncdn.com/ud/prod/zarr/warms9km/2026/10/27/12/demo_440300/2t.nc?auth_key=1793106000-68a5f1c0f31b9c578d5f5801-0-cb7ec1deafe05f5fc7c625dd8f3f5e93",
  "expires_at": 1793106000
}

响应字段

JSONPath	类型	说明
$.source	string	数据源标识，与请求参数一致，本产品为 warms9km
$.area_id	string	区域 ID，与请求路径一致
$.variable	string	变量名，与请求参数一致
$.base_time	string	该文件的起报时间，ISO 8601 格式（UTC）
$.url	string	NetCDF 文件下载地址（含临时认证参数 auth_key）
$.expires_at	number	url 的过期时间，Unix 时间戳（秒）

注意事项

• prate 的预报时效从 step=1 开始，不包含 step=0
• url 包含认证参数 auth_key，过期时间见 expires_at（1 小时）；过期后重新请求本接口获取新的下载地址
• 实际可用的 area_id 与变量以开通范围为准，未开通的组合返回 401
• 库中暂无对应产物时返回 404（no data found），与权限失败区分

错误

场景	典型响应
未传或无效的 token	401，鉴权失败
token 未开通该 source 与 area_id	401，无权限
缺少 source 或 variable，或 base_time 格式非法	400，BAD_PARAM
无对应产物	404，NOT_FOUND（no data found）

详见 错误信息。