功能介绍
该接口预报未来2小时不会下雨、具体降雨量,根据坐标实时预报5-10分钟
API文档在线测试此接口
请求方式及url:
请求方式:
GET
接口地址:(建议在服务端设置线路地址为动态可修改的)
- 线路1(推荐):
https://v0.yiketianqi.com/api
- 线路2:
https://yiketianqi.com/api
请求示例
https://yiketianqi.com/api?version=v11&appid=&appsecret=&lng=114.302953&lat=30.585411
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: v11 每个接口的version值都不一样
|
lng | 是 | string | 经度 | 如: 119.545023 |
lat | 是 | string | 纬度 | 如: 36.044254 |
point | 是 | string | 坐标体系 | 默认百度坐标, 如使用高德坐标, 请传参: gaode |
callback | 否 | string | jsonp参数 | 如: jQuery.Callbacks |
vue | 否 | string | 跨域参数 | 如果您使用的是react、vue、angular请填写值: 1 |
备注
暂无
响应字段说明
参数名 | 类型 | 说明 | 备注 |
---|---|---|---|
errcode | String | 错误代码 | 0 表示正常 |
time | String | 当前时间 | |
update_time | String | 更新时间 | |
msg | String | 预报提示 | 例如:40分钟后开始下小雨,不过55分钟后雨就停了 |
data | String | 数据列表 | |
┗ time | String | 时间点 | 例如:2020-01-20 15:35:00 |
┗ level | String | 降雨量级别 | 例如:小雨、中雨、大雨 |
┗ value | String | 降雨量数值 | 某一时段内的深度, 单位厘米, 例如:0.42 (4.2mm) |
响应JSON
{
"errcode":0,
"time":"2021-06-18 17:24:00",
"update_time":"2021-06-18 17:15:00",
"msg":"10分钟后开始下小雨,不过25分钟后雨就停了",
"data":[
{
"time":"2021-06-18 17:30:00",
"level":"",
"value":"0"
},
{
"time":"2021-06-18 17:35:00",
"level":"",
"value":"0"
},
{
"time":"2021-06-18 17:40:00",
"level":"小雨",
"value":"0.04"
},
{
"time":"2021-06-18 17:45:00",
"level":"小雨",
"value":"0.04"
},
{
"time":"2021-06-18 17:50:00",
"level":"小雨",
"value":"0.04"
},
{
"time":"2021-06-18 17:55:00",
"level":"",
"value":"0"
},
{
"time":"2021-06-18 18:00:00",
"level":"",
"value":"0"
},
{
"time":"2021-06-18 18:05:00",
"level":"小雨",
"value":"0.04"
},
{
"time":"2021-06-18 18:10:00",
"level":"小雨",
"value":"0.07"
},
{
"time":"2021-06-18 18:15:00",
"level":"小雨",
"value":"0.11"
},
{
"time":"2021-06-18 18:20:00",
"level":"小雨",
"value":"0.07"
},
{
"time":"2021-06-18 18:25:00",
"level":"小雨",
"value":"0.06"
},
{
"time":"2021-06-18 18:30:00",
"level":"小雨",
"value":"0.05"
},
{
"time":"2021-06-18 18:35:00",
"level":"小雨",
"value":"0.07"
},
{
"time":"2021-06-18 18:40:00",
"level":"小雨",
"value":"0.07"
},
{
"time":"2021-06-18 18:45:00",
"level":"小雨",
"value":"0.06"
},
{
"time":"2021-06-18 18:50:00",
"level":"小雨",
"value":"0.05"
},
{
"time":"2021-06-18 18:55:00",
"level":"小雨",
"value":"0.09"
},
{
"time":"2021-06-18 19:00:00",
"level":"小雨",
"value":"0.14"
},
{
"time":"2021-06-18 19:05:00",
"level":"小雨",
"value":"0.18"
},
{
"time":"2021-06-18 19:10:00",
"level":"小雨",
"value":"0.19"
}
]
}
示例代码
$ curl "https://yiketianqi.com/api?version=v11&appid=&appsecret=&lng=114.302953&lat=30.585411"
错误码参考
字段 | 错误码 | 说明 |
---|---|---|
errcode | 100 | 该接口有任何异常报错都会返回errcode报错, 并且只有100, 具体报错描述请参考字段:errmsg |
{ "errcode":100, "errmsg":"缺少注册参数appid或appsecret" }