实况天气接口/v2.2
当前版本:v2.2
授权与认证
授权
请先至彩云开放平台注册,注册后可以获得 token 。
认证
把您的 token 拼到 API 请求的 URL 中,如
https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json
其中 TAkhjf8d1nlSlspN 就是一个测试 token 。请注意不要把你的 token 告诉任何其他人。
天气现象
请求参数
要素
- 天气状态 skycon
- 温度 temperature
- 降雨 precipitation
- 降雨强度 precipitation:
- 风 wind
- 风向 wind:direction
- 风速 wind:speed
- 相对湿度 humidity
- 气压 pres
- 云量 cloudrate
- 能见度 visibility
单位制
语言
请求格式
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
数据返回样例和说明
{
"status":"ok",
"lang":"zh_CN", //目前只支持简体中文(zh_CN、zh_SG)、繁体中文(zh_TW、zh_HK),英语(en_US、en_GB)在测试中
"server_time":1443418222,
"tzshift":28800, //时区的偏移秒数,如东八区就是 28800 秒,使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区,它们有非整齐的偏移量
"location":[
25.1552, //纬度
121.6544 //经度
],
"unit":"metric", //目前只支持米制(metric)和科学计量法(SI),英制还有待开发
"result":{
"status":"ok",
"temperature":28.0, //温度
"skycon":"RAIN", //天气概况
"pm25": 11, //pm25值 在新的api中增加的字段
"cloudrate":0.51, // 云量
"humidity":0.92, //相对湿度
"precipitation":{ //降水
"nearest":{ //最近的降水带 //用户补充:nearest字段有时候没有
"status":"ok",
"distance":0.77, //距离
"intensity":0.3125 //降水强度
},
"local":{ //本地的降水
"status":"ok",
"intensity":0.2812, //降水强度,这是彩云自定义的一个量。如果需要mm/h,请在请求中加参数 ?unit=metric:v2
"datasource":"radar" //数据源
}
},
"wind":{ //风
"direction":25.33, //风向。单位是度。正北方向为0度,顺时针增加到360度。
"speed":83.3 //风速,米制下是公里每小时
}
}
}