Difference between revisions of "空气污染实况接口"
Liuzhonghua (talk | contribs) (Created page with "{{彩云天气 API 版本状态}} =='''授权与认证'''== 请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token...") |
Ringsaturn (talk | contribs) m (remove province station) (Tag: Visual edit) |
||
| (12 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
=='''授权与认证'''== | =='''授权与认证'''== | ||
| Line 5: | Line 4: | ||
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。 | 请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。 | ||
| − | + | 使用本接口，开发者token需要额外开通权限，请联系商务：'''api@caiyunapp.com''' | |
| − | + | 把您的 token 拼到 API 请求的 URL 中，如: [http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN <code>http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN</code>] | |
| − | |||
| − | </code> | ||
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！ | 其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！ | ||
| − | ==''' | + | =='''请求样例及参数说明'''== |
| − | + | 请求国控站点的数据： | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | [http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN <code>http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN</code>] | ||
=='''返回结构和说明'''== | =='''返回结构和说明'''== | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| − | { | + | { |
| − | + | status: ok | |
| − | + | category: aqi_latest_obs_city | |
| − | + | result: { | |
| − | + | 0000A02880: ## 彩云全球雾霾站点编号（10位字符串） | |
| − | + | { station_code: "0000A02880", ## 彩云全球雾霾站点编号（10位字符串） | |
| − | + | area: "成都市", ## 站点所在城市、城区、县级名称（中文或者英文） | |
| − | + | province_name:"四川", ## 站点所在省的名称 | |
| − | + | position_name:"大石西路", ## 站点地址（中文或者英文） | |
| − | + | lon: "104.0238889", | |
| − | + | lat: "30.65638889", ## 经纬度 | |
| − | + | time_point: "2019-01-14T17:00:00Z+08:00", ## 观测时间和时区信息 | |
| − | + | quality: "轻度污染", ## 空气污染等级，自然语言描述（中文） | |
| − | + | primary_pollutant: "细颗粒物(PM2.5)", ## 主要污染物（中文） | |
| − | + | pm25: "91", ## 细颗粒污染[μg/m3]，缺测为“null” | |
| − | + | pm10: "134", ## 粗颗粒污染[μg/m3]，缺测为“null” | |
| − | + | o3: "null", ## 臭氧[μg/m3]，缺测为“null” | |
| − | + | no2: "49" ## 二氧化氮[μg/m3]，缺测为“null” | |
| − | + | so2: "8", ## 二氧化硫[μg/m3]，缺测为“null” | |
| − | + | co: "1.1", ## 一氧化碳[mg/m3]，缺测为“null” | |
| − | + | aqi: "120" ## AQI（中国自然资源部，国标） | |
| − | + | }, | |
| − | + | 0000A02317:{...}, | |
| − | + | ... | |
| − | + | } | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
} | } | ||
| − | |||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | |||
[[Category:API 产品]] | [[Category:API 产品]] | ||
Latest revision as of 03:08, 28 May 2020
授权与认证
请先至彩云开放平台注册，注册后可以获得 token 。
使用本接口，开发者token需要额外开通权限，请联系商务：api@caiyunapp.com
把您的 token 拼到 API 请求的 URL 中，如: http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！
请求样例及参数说明
请求国控站点的数据：
http://api.caiyunapp.com/v1/aqi/latest?token=TAkhjf8d1nlSlspN
返回结构和说明
{
status: ok
category: aqi_latest_obs_city
result: {
0000A02880: ## 彩云全球雾霾站点编号（10位字符串）
{ station_code: "0000A02880", ## 彩云全球雾霾站点编号（10位字符串）
area: "成都市", ## 站点所在城市、城区、县级名称（中文或者英文）
province_name:"四川", ## 站点所在省的名称
position_name:"大石西路", ## 站点地址（中文或者英文）
lon: "104.0238889",
lat: "30.65638889", ## 经纬度
time_point: "2019-01-14T17:00:00Z+08:00", ## 观测时间和时区信息
quality: "轻度污染", ## 空气污染等级，自然语言描述（中文）
primary_pollutant: "细颗粒物(PM2.5)", ## 主要污染物（中文）
pm25: "91", ## 细颗粒污染[μg/m3]，缺测为“null”
pm10: "134", ## 粗颗粒污染[μg/m3]，缺测为“null”
o3: "null", ## 臭氧[μg/m3]，缺测为“null”
no2: "49" ## 二氧化氮[μg/m3]，缺测为“null”
so2: "8", ## 二氧化硫[μg/m3]，缺测为“null”
co: "1.1", ## 一氧化碳[mg/m3]，缺测为“null”
aqi: "120" ## AQI（中国自然资源部，国标）
},
0000A02317:{...},
...
}
}
