Skip to content

降水分省 API

接口说明

预报接口

请求方法: GET

URL: https://api.caiyunapp.com/v1/radar/cndata/forecastp

认证与鉴权

参数:

参数含义示例
token用户秘钥token=UpxxxxxxxxxxAm
province_id省份 IDprovince_id=11

完整示例: https://api.caiyunapp.com/v1/radar/cndata/forecastp?token=UpxxxxxxxxxxAm&province_id=51

省份 ID 示例列表:

省份省份 ID经纬度边界
北京11lat: [39.1505,41.2661], # 格点数据范围的南纬,北纬
lng: [114.8450,118.0462], # 格点数据范围的西经,东经

返回结果示例:

json
{
  "status": "ok",
  "cndata": [
    {
      "variable": "precp",
      "province_id": 11,
      "datetime": "2023-04-12T05:35:00",
      "data_url": [
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120535_14360bdcdd.nc?auth_key=1681281657-99456270d8f411ed9cb456fb3cbf242c-0-bfb106a228bdce7448a73821c3944e4c",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120540_33c278a169.nc?auth_key=1681281657-994564b4d8f411ed9cb456fb3cbf242c-0-eea420a963d3483be539eb207aad992a",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120545_bef5e00001.nc?auth_key=1681281657-994565b8d8f411ed9cb456fb3cbf242c-0-b40dff1d874e51047c7a9e0a4cbdc5d2",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120550_a24d689001.nc?auth_key=1681281657-99456694d8f411ed9cb456fb3cbf242c-0-ab4426243c134d0c2f181cf3457fdfb9",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120555_3681900005.nc?auth_key=1681281657-99456770d8f411ed9cb456fb3cbf242c-0-0e4729e9d95d311d0d117c335920f7ef",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120600_62e3057117.nc?auth_key=1681281657-9945684cd8f411ed9cb456fb3cbf242c-0-8022293ce9d4ad3156b246bdce3c91f1",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120605_e0629ce48c.nc?auth_key=1681281657-9945698cd8f411ed9cb456fb3cbf242c-0-6a7361f15519cb89f5b29f91420a9ed3",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120610_a20b22fe6b.nc?auth_key=1681281657-99456a68d8f411ed9cb456fb3cbf242c-0-63cd2dc713d42b1d86bc92875141a8b9",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120615_a6b6b82302.nc?auth_key=1681281657-99456b3ad8f411ed9cb456fb3cbf242c-0-21d36d1e239b6e40185e682a6d881542",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120620_914507a246.nc?auth_key=1681281657-99456c0cd8f411ed9cb456fb3cbf242c-0-fff0dbd9dfd75ae40c3e5c90be0fad8b",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120625_7293d2312e.nc?auth_key=1681281657-99456cded8f411ed9cb456fb3cbf242c-0-6c828d38404d37f913aa652a462eae02",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120630_b9ac2b6d12.nc?auth_key=1681281657-99456da6d8f411ed9cb456fb3cbf242c-0-be43110e1951ce4feaaee92eadf5029e",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120635_05482815ac.nc?auth_key=1681281657-99456e78d8f411ed9cb456fb3cbf242c-0-e553bf25189adf6ea3b7e0471ffa555e",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120640_39723bd468.nc?auth_key=1681281657-99456f40d8f411ed9cb456fb3cbf242c-0-a9b182af65b1bb54234edcea19d0bc80",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120645_bb64bf657b.nc?auth_key=1681281657-99457008d8f411ed9cb456fb3cbf242c-0-9fb907c8d77744ebba8dec316b52d4f6",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120650_9519cfbd66.nc?auth_key=1681281657-994570d0d8f411ed9cb456fb3cbf242c-0-0bd29e4644975c506073b2d21ac598c9",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120655_c634723723.nc?auth_key=1681281657-99457198d8f411ed9cb456fb3cbf242c-0-38d1a136762252504c420a99df422768",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120700_a02cb3e7ba.nc?auth_key=1681281657-9945726ad8f411ed9cb456fb3cbf242c-0-8c9d753c97d50384fc44afa136c03e69",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120705_52e77071a0.nc?auth_key=1681281657-99457332d8f411ed9cb456fb3cbf242c-0-8978f5340f2c4617a48a1548032e24bd",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120710_cf71bc7056.nc?auth_key=1681281657-994573fad8f411ed9cb456fb3cbf242c-0-e3309b389c0477239d829fe5e0b8f405",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120715_c3fce1c874.nc?auth_key=1681281657-994574c2d8f411ed9cb456fb3cbf242c-0-efb675ad83fc5c276ad2f2f22fe108e8",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120720_96fad6ecf8.nc?auth_key=1681281657-9945758ad8f411ed9cb456fb3cbf242c-0-50984e41e0a53025d2902f9ea0e3de02",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120725_95e216ffab.nc?auth_key=1681281657-99457652d8f411ed9cb456fb3cbf242c-0-75ae4fbbc005410a48c3583101dc574c",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120730_694e849ad5.nc?auth_key=1681281657-99457724d8f411ed9cb456fb3cbf242c-0-45407edc99c7d653e73af16bf3e50747",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120735_c4a564d6f9.nc?auth_key=1681281657-994577ecd8f411ed9cb456fb3cbf242c-0-75139d143f05a438acb13c965ba09fc3",
        "https://meteorology.caiyuncdn.com/radar/prod/china/cnmap_forecast_by_province/2023/04/12/cnmap_precp_nc_11_202304120535_202304120740_3818778448.nc?auth_key=1681281657-994578b4d8f411ed9cb456fb3cbf242c-0-22a731ecbf5a311aece70658e02f3bde"
      ]
    }
  ]
}

实况接口

请求方法: GET

URL: https://api.caiyunapp.com/v1/radar/cndata/realtimep

认证与鉴权

参数:

参数含义示例
token用户秘钥token=UpxxxxxxxxxxAm
province_id省份 IDprovince_id=11

完整示例: https://api.caiyunapp.com/v1/radar/cndata/realtimep?token=UpxxxxxxxxxxAm&province_id=51

省份 ID 示例列表:

省份省份 ID经纬度边界
北京11lat: [39.1505,41.2661], # 格点数据范围的南纬,北纬
lng: [114.8450,118.0462], # 格点数据范围的西经,东经

数据说明

数据格式: NetCDF4

元信息: 自描述二维网格数据文件,文件内部包含经纬度、时间等必要的元信息。降水值 precip 为彩云内部降水强度(0-255),无单位,不同省份的经纬度信息不同。降水值 precipitation 为经过公式转换后的降水强度,单位为 mm/h。

请直接使用 precipitation 变量,precip 为了兼容老用户而保留,在老用户切换完毕以后将从文件中剔除。

时效性: 在线上全国分钟级降水灰度图生成后,延迟 2~3 分钟生成。

元信息示例:

dimensions:
  lon = 305;
  time = 1;
  lat = 235;

variables:
  float lon(lon=305);
    :long_name = "longitude";
    :standard_name = "longitude";
    :units = "degrees_east";

  long time(time=1);
    :units = "seconds since 1970-01-01 00:00:00";
    :long_name = "time";
    :timezone = "UTC";

  float lat(lat=235);
    :long_name = "latitude";
    :standard_name = "latitude";
    :units = "degrees_north";

  float precip(time=1, lat=235, lon=305);
    :_FillValue = -9999.0f; // float
    :long_name = "precipitation intensity";
    :units = "None";
    :_ChunkSizes = 1U, 235U, 305U; // uint

  float precipitation(time=1, lat=235, lon=305);
    :_FillValue = -9999.0f; // float
    :long_name = "precipitation intensity";
    :units = "mm/h";
    :_ChunkSizes = 1U, 235U, 305U; // uint

// global attributes:
:copyright = "Beijing ColorfulClouds Technology Co.,Ltd.";
:init_forecast_time = "2023-04-12T04:50:00+00:00";
:update_time = "2023-04-12T12:51:58.134932+08:00";