Difference between revisions of "雾霾区域实况图接口"
Liuzhonghua (talk | contribs) (Tag: Visual edit) |
Liuzhonghua (talk | contribs) (Tag: Visual edit) |
||
(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> | ||
+ | |||
=='''授权与认证'''== | =='''授权与认证'''== | ||
− | + | <blockquote>请先至彩云开放平台注册,注册后可以获得 token 。使用本接口,开发者token需要额外开通权限,请联系商务:api@caiyunapp.com</blockquote> | |
+ | |||
=='''请求样例'''== | =='''请求样例'''== | ||
− | <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"> | <blockquote><syntaxhighlight lang="javascript"> | ||
Line 11: | Line 17: | ||
{ status "ok" | { status "ok" | ||
category "aqi_latest_obs_image" | category "aqi_latest_obs_image" | ||
− | + | 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> | ||
− | + | 样例二(北美): | |
<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" | ||
− | + | 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:{...} #当前实况帧 }