单站雷达

访问限制

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

按经纬度返回对应雷达站的单站雷达图，需按雷达站单独开通权限。

返回字段与可视化方式同雷达图中 level=1 单站接口。

实况

请求

GET https://api.caiyunapp.com/v1/radar/station/images

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
lon	是	—	—	经度
lat	是	—	—	纬度

请求示例

curl "https://api.caiyunapp.com/v1/radar/station/images?lon=116.427301&lat=39.902451&token={token}"

响应示例

{
  "status": "ok",
  "timezone": "Asia/Shanghai",
  "tzshift": 28800,
  "station": "NMIC_AZ9010",
  "images": [
    [
      "http://cdn-s.caiyunapp.com/weather/radar/color/AZ9010_1640780414_1640780414_ab4b91d31f3f45bca005040f96f42041.png?auth_key=xxx",
      1640780414,
      [
        37.742471186275736,
        113.78227438031607,
        41.874723213724266,
        119.16149781968394
      ]
    ]
  ]
}

响应字段

JSONPath	类型	说明
$.status	string	请求状态
$.timezone	string	雷达站所在时区
$.tzshift	number	时区偏移秒数
$.station	string	匹配到的雷达站 ID
$.images	array<array>	雷达图 URL、时间戳和经纬度边界的列表

备注

• 根据请求坐标匹配最近雷达站，返回该站过去 20 帧实况图，4~6 分钟一帧。
• Token 需具备对应雷达站权限，权限路径为 /v1/radar/station/images/{station_id}，其中 {station_id} 为响应中的 station 字段。

预报

请求

GET https://api.caiyunapp.com/v1/radar/station/forecast_images

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
lon	是	—	—	经度
lat	是	—	—	纬度

请求示例

curl "https://api.caiyunapp.com/v1/radar/station/forecast_images?lon=116.427301&lat=39.902451&token={token}"

响应示例

{
  "status": "ok",
  "station": "NMIC_AZ9010",
  "images": [
    [
      "http://cdn-s.caiyunapp.com/weather/radar/color/AZ9010_1640780414_1640780414_ab4b91d31f3f45bca005040f96f42041.png?auth_key=xxx",
      1640780414,
      [
        37.742471186275736,
        113.78227438031607,
        41.874723213724266,
        119.16149781968394
      ]
    ]
  ]
}

响应字段

JSONPath	类型	说明
$.status	string	请求状态
$.station	string	匹配到的雷达站 ID
$.images	array<array>	雷达图 URL、时间戳和经纬度边界的列表

备注

• 返回最新一帧实况图及未来两小时预报图，共 25 帧，逐 4~6 分钟一帧。
• Token 需具备对应雷达站权限，权限路径为 /v1/radar/station/forecast_images/{station_id}，其中 {station_id} 为响应中的 station 字段。