区域裁切-分钟级雷达灰度图

访问限制

本部分 API 属于增值服务，仅提供给企业套餐开发者，如需采购请联系彩云商务

请求

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

• 错误信息

路径参数

参数	说明
task_type	任务类型：realtime 或 forecast
area_id	区域 ID；下方示例使用 150622

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
init_time	否	—	整 5 分钟的 Unix 时间戳	指定批次时间

请求示例

1. 实时任务（task_type=realtime）示例：

curl "https://singer.caiyunhub.com/v3/ud/radar_gray/realtime/150622?token={token}"

2. 预报任务（task_type=forecast）示例：

curl "https://singer.caiyunhub.com/v3/ud/radar_gray/forecast/150622?token={token}"

3. 指定 init_time 示例

3.1 realtime

curl "https://singer.caiyunhub.com/v3/ud/radar_gray/realtime/150622?init_time=1751356200&token={token}"

3.2 forecast

curl "https://singer.caiyunhub.com/v3/ud/radar_gray/forecast/150622?init_time=1751356200&token={token}"

响应示例

1. task_type=realtime（实时）

{
  "task_type": "realtime",
  "init_time": 1751347800,
  "items": [
    {
      "area_id": "150622",
      "forecast_time": 1751347800,
      "bound": [103.00350189208984, 36.007301330566406, 116.9884033203125, 42.002201080322266],
      "url": "http://meteorology.caiyuncdn.com/ud/radar_gray/prod/realtime/2025/07/01/150622/cnmap_precp_202507010530.png?auth_key=1751351488-686372b0f31b9c578d5f580b-0-cb7ec1deafe05f5fc7c625dd8f3f5e93"
    }
  ]
}

2. task_type=forecast（预报）

{
  "task_type": "forecast",
  "init_time": 1751351700,
  "items": [
    {
      "area_id": "150622",
      "forecast_time": 1751351700,
      "bound": [103.00350189208984, 36.007301330566406, 116.9884033203125, 42.002201080322266],
      "url": "http://meteorology.caiyuncdn.com/ud/radar_gray/prod/forecast/2025/07/01/202507010635/150622/cnmap_precp_202507010635.png?auth_key=1751355471-6863823ff31b9c578d5f7032-0-2c7964464aa9c50b7662dbf56a1569e2"
    },
    {
      "area_id": "150622",
      "forecast_time": 1751352000,
      "bound": [103.00350189208984, 36.007301330566406, 116.9884033203125, 42.002201080322266],
      "url": "http://meteorology.caiyuncdn.com/ud/radar_gray/prod/forecast/2025/07/01/202507010635/150622/cnmap_precp_202507010640.png?auth_key=1751355471-6863823ff31b9c578d5f7033-0-6c0f3a44f1e4ed0c3182f38d4972afdf"
    }
  ]
}

响应字段

JSONPath	类型	说明
$.task_type	string	任务类型，与请求参数一致（realtime/forecast）
$.init_time	number	数据初始化时间戳（示例值：1751347800）
$.items	array<object>	切割图数据列表
$.items[].area_id	string	区域 ID（与请求参数一致）
$.items[].forecast_time	number	数据对应的预报/实时时间戳
$.items[].bound	array<number>	地理范围经纬度边界：[左经度, 下纬度, 右经度, 上纬度]
$.items[].url	string	灰度切割图图片 URL（含临时认证参数 auth_key）

数据情况

• realtime: 5 分钟一个文件
• forecast: 5 分钟一个批次，单个批次 26 个文件

forecast 默认给出的接口是最新批次，加工过程中可能会少于 26 个文件。可进行判断，如果当前不足，取前几个批次。

数据使用

灰度数据是彩云内部强度，需要经过转换之后才是雷达的 dbz，具体转化过程如下：

# 以 opencv-python 读取为例
import cv2

img = cv2.imread('your_file_path.png', cv2.IMREAD_GRAYSCALE)

# 1 灰度值 除以 255
intn = img.copy() / 255

# 2 大于零的数据 + 0.15
intn[intn > 0] = intn[intn > 0] + 0.15

# 3 数据转换
val = intn * 16.0 * 5

# 4 dbz 计算
dbz = 70 * (val > 70) + val * (val <= 70)