雷达实况图API接口 - Revision history

Mengqingye at 08:36, 19 May 2020

2020-05-19T08:36:16Z

Mengqingye at 08:32, 19 May 2020

2020-05-19T08:32:47Z

Mengqingye: Created page with "
=='''API概述：'''==
雾霾区域实况图 API，提供两个区域的pm25实况栅格图：亚洲和北美（全球两切片)；
2020-05-19T07:47:33Z

Created page with "<blockquote></blockquote> =='''API概述：'''== <blockquote>雾霾区域实况图 API，提供两个区域的pm25实况栅格图：亚洲和北美（全球两切片)；</b..."

New page
<blockquote></blockquote>

=='''API概述：'''==
<blockquote>雾霾区域实况图 API，提供两个区域的pm25实况栅格图：亚洲和北美（全球两切片)；</blockquote><blockquote>API会根据经纬度范围，自动选择亚洲或北美雾霾图返回(未来会提供欧洲雾霾切片)；</blockquote><blockquote>文件名为格林威治时间，提供最近48帧（47逐小时历史+实况），每60分钟更新1次（从00H:00M开始）；</blockquote>

=='''授权与认证'''==
<blockquote>请先至彩云开放平台注册，注册后可以获得 token 。使用本接口，开发者token需要额外开通权限，请联系商务：api@caiyunapp.com</blockquote>

=='''请求样例'''==
<blockquote>样例一（亚洲）：api.caiyunapp.com/v1/aqi/images?token=@TOKEN&lon=120&lat=20</blockquote><blockquote>样例二（北美）：api.caiyunapp.com/v1/aqi/images?token=@TOKEN&lon=-120&lat=20</blockquote><blockquote>'''参数：'''</blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 121.6544,25.1552；API会根据经纬度范围，自动选择亚洲或北美雾霾图返回（全球两切片)</blockquote><blockquote>'''token ：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote>

=='''返回结构和说明'''==
样例一（亚洲）：

<blockquote><syntaxhighlight lang="javascript">

{ status "ok"
category "aqi_latest_obs_image"
images:
0:{ #历史-48h帧
0: "http://cdn.caiyunapp.com/weather/pm25_rt_as_20190318_05.png", #UTC时间
1: 1552885200, #UTC时间戳
2:{
-10, #图片最南处纬度 lat0
60, #图片最西处经度 lon0
56, #图片最北处纬度 lat1
146 #图片最东处经度 lon1
}
},
1:{...},
...
47:{...} #当前实况帧
}

</syntaxhighlight></blockquote>

样例二（北美）：

<blockquote><syntaxhighlight lang="javascript">

{ status "ok"
category "aqi_latest_obs_image"
images:
0:{ #历史-48h帧
0: "http://cdn.caiyunapp.com/weather/pm25_rt_na_20190318_05.png" #UTC时间
1: 1552885200 #UTC时间戳
2:{
15, #图片最南处纬度 lat0
-169, #图片最西处经度 lon0
71.5, #图片最北处纬度 lat1
-52 #图片最东处经度 lon1
}
},
1:{...},
...
47:{...} #当前实况帧
}

</syntaxhighlight></blockquote>

@@ Line 38: / Line 38: @@
      ],
+}
-</syntaxhighlight><blockquote></blockquote>
+</syntaxhighlight>

@@ Line 1: / Line 1: @@
 <blockquote></blockquote>
-=='''API概述 ：'''==
+==API概述 '''：'''==
-<blockquote>雾霾区域实况图 API， 提供两个区域的pm25实况栅格图：亚洲和北美（全球两切片)；</blockquote><blockquote>API会根据经纬度范围，自动选择亚洲或北美雾霾图返回(未来会提供欧洲雾霾切片)；</blockquote><blockquote>文件名为格林威治时间，提供最近48帧（47逐小时历史+实况），每60分钟更新1次（从00H:00M开始）；</blockquote>
+<blockquote>根据经纬度返回对应的实况雷达单站图和实况雷达区域拼图。</blockquote>
 =='''授权与认证'''==
 <blockquote>请先至彩云开放平台注册，注册后可以获得 token 。使用本接口，开发者token需要额外开通权限，请联系商务：api@caiyunapp.com</blockquote>
-=='''请求样例'''==
+==API请求==
-样例二（北美）：
+=== 示例 ===
-	<blockquote><syntaxhighlight lang="javascript">
+=== '''请求参数：''' ===
-{  status	"ok"
+==API 返回结果==
-   category	"aqi_latest_obs_image"
+<syntaxhighlight lang="yaml">
-   images:
-:{                                                                        #历史-48h帧
+    status: "ok",                   #请求的状态
-: "http://cdn.caiyunapp.com/weather/pm25_rt_na_20190318_05.png"       #UTC时间
+    timezone: "Asia/Shanghai",      #时区
-: 1552885200                                                          #UTC时间戳
+    tzshift: 28800,                 #时区的偏移秒数，如东八区就是 28800 秒
-:{
+    station: "CN01",                #单站雷达的站点编号或者区域拼图的编号
-,                                                                #图片最南处纬度 lat0
+    images: [                       #雷达图的列表
-                 -169,                                                               #图片最西处经度 lon0
-.5,                                                              #图片最北处纬度 lat1
+ "http://cdn.caiyunapp.com/res/storm_radar/radar_CN01_nmc_fast/202005191207.png", # 雷达图片的url
-                   -52                                                                #图片最东处经度 lon1
+        1589861276,                 #雷达图的时间戳
-−
+        [
-            },
+.9079,                    #雷达图的西南角的纬度
-:{...},
+.9282,                   #雷达图的西南角的经度
-            ...
+.9079,                   #雷达图的东北角的纬度
-:{...}                                                                   #当前实况帧
+.8656                   #雷达图的东北角的经度
+}
+</syntaxhighlight><blockquote></blockquote>