华东数值预报区域网格数据 API

接口说明

预报接口

请求方法： GET

URL： https://singer.caiyunhub.com/v3/nwc/china/nc/region_cut/{var_name}

• 认证与鉴权 | 错误信息

支持变量

变量	变量说明
rain_0m	地面降水量：mm
t_2m	近地面 2m 处的气温：单位 ℃

请求参数

参数	含义	示例
token	用户秘钥	token=xxxxxxxxxx
province_id	省份 ID	province_id=54

完整示例： https://singer.caiyunhub.com/v3/nwc/china/nc/region_cut/rain_0m?token=xxxxxx&province_id=54

省份 ID 列表

省份	省份 ID	经纬度边界
西藏自治区	54	lat: [26.56,36.74], # 格点数据范围的南纬，北纬 lng: [78.13,99.51], # 格点数据范围的西经，东经

数据说明

• 数据格式： NetCDF4
• 元信息： 自描述二维网格数据文件，文件内部包含经纬度等必要的元信息
• 时间跨度： 为每天 UTC 时间 00:00 和 12:00 起报的未来 72h，每小时 1 个文件
• 空间分辨率： 0.02° (约 2 km)

返回说明

返回字段说明

字段	数据类型	说明
province_id	string	省份 ID
var_name	string	变量名
batch_time	string	起报时间
items	list	数据列表
items.#.step	int	预报步长
items.#.valid_time	string	数据时间
items.#.url	string	文件链接

文件链接说明（不包含 auth_key）

pattern = "{host}/{prefix}/YYYY/YYYYMM/YYYYMMDD/{province_id}/YYYYMMDDHH_{step:02d}.{var_name}.nc"

# 例如：
host = "https://meteorology.caiyuncdn.com"
prefix = "nafp-warms9km/develop/nafp_nc_p"
time = "2024091812"
step = 1
var_name = "rain_0m"

# 时间相关说明：YYYY 代表四位数年，比如 2024；MM 代表月份，比如 01；DD 代表天比如 02；HH 代表小时比如 03
# 对应的路径为
url = "https://meteorology.caiyuncdn.com/nafp-warms9km/develop/nafp_nc_p/2024/202409/20240918/54/2024091812_01.rain_0m.nc"

返回结果示例

{
  "province_id": "54",
  "var_name": "rain_0m",
  "batch_time": "2024-09-18T12:00:00Z",
  "items": [
    {
      "step": 1,
      "valid_time": "2024-09-18T13:00:00Z",
      "url": "https://meteorology.caiyuncdn.com/nafp-warms9km/develop/nafp_nc_p/2024/202409/20240918/54/2024091812_01.rain_0m.nc?auth_key=1726733386-66ebce3aabb41b23cdc40789-0-d1f8254ff70ab317e2518a4d6d5179ec"
    },
    {
      "step": 2,
      "valid_time": "2024-09-18T14:00:00Z",
      "url": "https://meteorology.caiyuncdn.com/nafp-warms9km/develop/nafp_nc_p/2024/202409/20240918/54/2024091812_02.rain_0m.nc?auth_key=1726733386-66ebce3aabb41b23cdc4078a-0-9557c8ffb5b1351c537333483bf65606"
    },
    {
      "step": 3,
      "valid_time": "2024-09-18T15:00:00Z",
      "url": "https://meteorology.caiyuncdn.com/nafp-warms9km/develop/nafp_nc_p/2024/202409/20240918/54/2024091812_03.rain_0m.nc?auth_key=1726733386-66ebce3aabb41b23cdc4078b-0-de3631fbbcd7bcaf26ee7f7c134ecd6f"
    }
  ]
}