空气污染实况接口

From CaiyunWiki
Revision as of 04:50, 15 January 2019 by Liuzhonghua (talk | contribs) (Created page with "{{彩云天气 API 版本状态}} =='''授权与认证'''== 请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册],注册后可以获得 token...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

本文版本:空气污染实况接口,当前稳定版本版本:v2.5,历史版本:v2.2v2.3,和 v2.4

授权与认证

请先至彩云开放平台注册,注册后可以获得 token 。

把您的 token 拼到 API 请求的 URL 中,如

https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人!

请求样例

示例1如下
https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json
https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.jsonp?callback=MYCALLBACK
token :这里是测试 token ,即 TAkhjf8d1nlSlspN
经纬度:经度在前,纬度在后,中间用半角逗号隔开,这里是 121.6544,25.1552
返回格式:json 或者 jsonp,jsonp 需提供回调函数名

示例2如下

https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json?lang=en_US
语言选项 lang:默认为简体中文(zh_CN)、繁体中文(zh_TW)、美式英语(en_US)、英式英语(en_GB)
单位制选项 unit:默认为公制(metric)、科学单位体系(SI) 、英制(imperial)
时区偏移秒数 tzshift:默认为东八区,tzshift=28800;例如:印度东5.5区,tzshift=3600*5.5==19800,使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区,它们有非整齐的偏移量

返回结构和说明

{   status:ok,
    api_version:v2.2,                                          // 版本号
    api_status:active,                                         // 版本号状态
    lang:zh_CN,                                                // 语言
    unit:metric,                                               // 单位制
    result:{
        status:ok,                                             // 实况模块返回状态
        temperature:28.0,                                          // 温度
        pres: 100991.3,                                            // 气压
        humidity:0.92,                                             // 相对湿度
        wind:{direction:25.33,                                     // 风向,单位是度。正北方向为0度,顺时针增加到360度。
              speed:83.3},                                         // 风速,米制下是公里每小时
        precipitation:{ nearest:{status:ok,
                                 distance:0.77,                    // 最近的降水带距离
                                 intensity:0.3125},                // 最近的降水带降水强度(单位为雷达降水强度)
                        local:{status:ok,
                               intensity:0.2812,                   // 本地降水强度(单位为雷达降水强度)
                               datasource:radar} },                // 本地降水观测的数据源(radar,GFS)
        cloudrate:0.51,                                            // 云量
        dswrf: 8.3,                                                // 向下短波辐射通量
        visibility: 8.3,                                            // 能见度

        skycon:RAIN,                                               // 主要天气现象
        comfort: {                                                 // 舒适度指数及其自然语言描述
            index: 7,
            desc: },
        ultraviolet: {                                             // 紫外线指数及其自然语言描述
           index: 0,
           desc: },

        pm25: 18,                                                  // pm25,质量浓度值
        pm10: 46,                                                  // pm10,质量浓度值
        o3: 47,                                                    // 臭氧,质量浓度值
        no2: 14,                                                   // 二氧化氮,质量浓度值
        so2: 1,                                                    // 二氧化硫,质量浓度值
        co: 0.3,                                                   // 一氧化碳,质量浓度值
        aqi: 46,                                                   // AQI(国标)
    },
    location:[25.1552,
              121.6544],                                       // 经纬度
    placename	"崁脚里"                                     // 经纬度处地址
    server_time:1443418222,                                    // 服务器本次返回的utc时间戳
    tzshift:28800,                                             // 时区的偏移秒数,如东八区就是 28800 秒
}