Difference between revisions of "雾霾区域实况图接口"

From Caiyun Wiki
Jump to: navigation, search
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
<blockquote></blockquote>
 +
 +
=='''API概述 :'''==
 +
<blockquote>雾霾区域实况图 API, 提供两个区域的pm25实况栅格图:亚洲和北美(全球两切片);</blockquote><blockquote>API会根据经纬度范围,自动选择亚洲或北美雾霾图返回(未来会提供欧洲雾霾切片);</blockquote><blockquote>文件名为格林威治时间,提供最近48帧(47逐小时历史+实况),每60分钟更新1次(从00H:00M开始);</blockquote>
 +
 
=='''授权与认证'''==
 
=='''授权与认证'''==
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册],注册后可以获得 token 。<code>使用本接口,开发者token需要额外开通权限,请联系商务:'''api@caiyunapp.com'''</code>
+
<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>样例一(亚洲):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>
  
 
=='''返回结构和说明'''==
 
=='''返回结构和说明'''==
api.caiyunapp.com/v1/aqi/images?token=@TOKEN&lon=120&lat=20
+
样例一(亚洲):
 
 
 
<blockquote><syntaxhighlight lang="javascript">
 
<blockquote><syntaxhighlight lang="javascript">
Line 11: Line 17:
 
{  status "ok"
 
{  status "ok"
 
   category "aqi_latest_obs_image"
 
   category "aqi_latest_obs_image"
   imagee:
+
   images:
           0:{
+
           0:{                                                                       #历史-48h帧
               0: "http://cdn.caiyunapp.com/weather/pm25_rt_as_20190318_05.png",
+
               0: "http://cdn.caiyunapp.com/weather/pm25_rt_as_20190318_05.png",     #UTC时间
               1: 1552885200,
+
               1: 1552885200,                                                         #UTC时间戳
 
               2:{
 
               2:{
 
                 -10,                                                                #图片最南处纬度 lat0
 
                 -10,                                                                #图片最南处纬度 lat0
Line 21: Line 27:
 
                 146                                                                #图片最东处经度 lon1
 
                 146                                                                #图片最东处经度 lon1
 
                 }
 
                 }
             }
+
             },
 +
          1:{...},
 +
            ...
 +
          47:{...}                                                                  #当前实况帧
 
}
 
}
  
 
</syntaxhighlight></blockquote>
 
</syntaxhighlight></blockquote>
  
api.caiyunapp.com/v1/aqi/images?token=@TOKEN&lon=-120&lat=20
+
样例二(北美):
  
 
<blockquote><syntaxhighlight lang="javascript">
 
<blockquote><syntaxhighlight lang="javascript">
Line 32: Line 41:
 
{  status "ok"
 
{  status "ok"
 
   category "aqi_latest_obs_image"
 
   category "aqi_latest_obs_image"
   imagee:
+
   images:
           0:{
+
           0:{                                                                       #历史-48h帧
               0: "http://cdn.caiyunapp.com/weather/pm25_rt_na_20190318_05.png"
+
               0: "http://cdn.caiyunapp.com/weather/pm25_rt_na_20190318_05.png"       #UTC时间
               1: 1552885200
+
               1: 1552885200                                                         #UTC时间戳
 
               2:{
 
               2:{
 
                   15,                                                                #图片最南处纬度 lat0
 
                   15,                                                                #图片最南处纬度 lat0
Line 42: Line 51:
 
                   -52                                                                #图片最东处经度 lon1
 
                   -52                                                                #图片最东处经度 lon1
 
                 }
 
                 }
             }
+
             },
 +
          1:{...},
 +
            ...
 +
          47:{...}                                                                  #当前实况帧
 
}
 
}
  
 
</syntaxhighlight></blockquote>
 
</syntaxhighlight></blockquote>

Latest revision as of 06:28, 20 March 2019

API概述 :

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

授权与认证

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

请求样例

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

返回结构和说明

样例一(亚洲):

{  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:{...}                                                                   #当前实况帧
}

样例二(北美):

{  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:{...}                                                                   #当前实况帧
}