雷达预报图API接口

From Caiyun Wiki
Jump to: navigation, search

API概述

根据经纬度返回对应的雷达预报单站图和雷达预报区域拼图。

授权与认证

请先至彩云开放平台注册,注册后可以获得 token 。使用本接口,开发者token需要额外开通权限,请联系商务:api@caiyunapp.com

API请求

示例

http://api.caiyunapp.com/v1/radar/forecast_images?lon=116.427301&lat=39.902451&level=1&token=TOKEN

请求参数:

  • lon:必须,无缺省值,经度。
  • lat:必须,无缺省值,纬度。
  • level: 必须,无缺省值,雷达图的类型。1 代表单站图,2 代表区域拼图。
  • token :必须,无缺省值,token。

API 返回结果

{
    status: "ok",                   #请求的状态
    station: "NMIC_AZ9010",         #单站雷达的站点编号或者区域拼图的编号
    images: [                       #雷达图的列表
        [    
 "http://cdn.caiyunapp.com/weather/radar/color/AZ9010_1589878231_1589878231_5e1b05635d504e32ae8de63e0255dfec.png", # 雷达图片的url
        1589878231,                 #雷达图的时间戳
        [
         37.742471186275736,        #雷达图的西南角的纬度
         113.78227438031607,        #雷达图的西南角的经度  
         41.874723213724266,        #雷达图的东北角的纬度
         119.16149781968394         #雷达图的东北角的经度
        ],
       [...],
       [...],
    ],
}

备注:

  • 雷达图的 URL 如果没有 domain,请使用 http[s]://cdn.caiyunapp.com