Skip to content

单站雷达

访问限制

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

按经纬度返回对应雷达站的单站雷达图。本接口属于增值产品,需按雷达站单独开通权限,请联系商务

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

实况

请求方法: GET

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

认证与鉴权

参数:

参数含义示例
token用户秘钥token=UpxxxxxxxxxxAm
lon经度lon=116.427301
lat纬度lat=39.902451

完整示例:

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

数据说明:

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

返回结果示例:

json
{
  "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
      ]
    ]
  ]
}

预报

请求方法: GET

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

认证与鉴权

参数:

参数含义示例
token用户秘钥token=UpxxxxxxxxxxAm
lon经度lon=116.427301
lat纬度lat=39.902451

完整示例:

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

数据说明:

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

返回结果示例:

json
{
  "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
      ]
    ]
  ]
}