Difference between revisions of "雷达预报图API接口"

From Caiyun Wiki
Jump to: navigation, search
(Created page with " ==API概述 ''':'''== <blockquote>根据经纬度返回对应的实况雷达单站图和实况雷达区域拼图。</blockquote> =='''授权与认证'''== <blockquote>请...")
 
 
Line 1: Line 1:
  
 
==API概述 ''':'''==
 
==API概述 ''':'''==
<blockquote>根据经纬度返回对应的实况雷达单站图和实况雷达区域拼图。</blockquote>
+
<blockquote>根据经纬度返回对应的雷达预报单站图和雷达预报区域拼图。</blockquote>
 
=='''授权与认证'''==
 
=='''授权与认证'''==
 
<blockquote>请先至彩云开放平台注册,注册后可以获得 token 。使用本接口,开发者token需要额外开通权限,请联系商务:api@caiyunapp.com</blockquote>
 
<blockquote>请先至彩云开放平台注册,注册后可以获得 token 。使用本接口,开发者token需要额外开通权限,请联系商务:api@caiyunapp.com</blockquote>
Line 8: Line 8:
  
 
=== 示例 ===
 
=== 示例 ===
http://api.caiyunapp.com/v1/radar/images?lon=116.427301&lat=39.902451&level=1&token=TOKEN
+
http://api.caiyunapp.com/v1/radar/forecast_images?lon=116.427301&lat=39.902451&level=1&token=TOKEN
  
 
=== '''请求参数:''' ===
 
=== '''请求参数:''' ===
 
* lon:必须,无缺省值,经度。
 
* lon:必须,无缺省值,经度。
 
* lat:必须,无缺省值,纬度。
 
* lat:必须,无缺省值,纬度。
* level:  雷达图的类型,缺省值为1。1 代表单站图,2 代表区域拼图。
+
* level:  必须,无缺省值,雷达图的类型。1 代表单站图,2 代表区域拼图。
 
* token :必须,无缺省值,token。
 
* token :必须,无缺省值,token。
  
Line 20: Line 20:
 
{
 
{
 
     status: "ok",                  #请求的状态
 
     status: "ok",                  #请求的状态
    timezone: "Asia/Shanghai",      #时区
+
     station: "NMIC_AZ9010",         #单站雷达的站点编号或者区域拼图的编号
    tzshift: 28800,                #时区的偏移秒数,如东八区就是 28800 秒
 
     station: "CN01",               #单站雷达的站点编号或者区域拼图的编号
 
 
     images: [                      #雷达图的列表
 
     images: [                      #雷达图的列表
 
         [     
 
         [     
  "http://cdn.caiyunapp.com/res/storm_radar/radar_CN01_nmc_fast/202005191207.png", # 雷达图片的url
+
  "http://cdn.caiyunapp.com/weather/radar/color/AZ9010_1589878231_1589878231_5e1b05635d504e32ae8de63e0255dfec.png", # 雷达图片的url
         1589861276,                #雷达图的时间戳
+
         1589878231,                #雷达图的时间戳
 
         [
 
         [
         3.9079,                   #雷达图的西南角的纬度
+
         37.742471186275736,       #雷达图的西南角的纬度
         71.9282,                   #雷达图的西南角的经度   
+
         113.78227438031607,       #雷达图的西南角的经度   
         57.9079,                   #雷达图的东北角的纬度
+
         41.874723213724266,       #雷达图的东北角的纬度
         134.8656                  #雷达图的东北角的经度
+
         119.16149781968394        #雷达图的东北角的经度
 
         ],
 
         ],
 
       [...],
 
       [...],

Latest revision as of 09:00, 19 May 2020

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