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

请求

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

• 错误信息

路径参数

参数	说明
var_name	变量名称，见下方列表

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
province_id	是	—	—	省份 ID

请求示例

curl "https://singer.caiyunhub.com/v3/nwc/china/nc/region_cut/rain_0m?token={token}&province_id=54"

支持变量

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

省份 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)

返回说明

响应字段

JSONPath	类型	说明
$.province_id	string	省份 ID
$.var_name	string	变量名
$.batch_time	string	起报时间
$.items	array<object>	数据列表
$.items[].step	number	预报步长
$.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"
    }
  ]
}