天气的好坏和人们的生活、工作息息相关,每天的天气如何?总是牵动着人们的心,关注天气就行了人们茶余饭后的话题了。如何获得准确的天气预报?还得从天气预报API接口说起。
天气预报API是提供未来天气预报数据的一个API调用接口,通过此接口可以获取一个城市的温度、PM2.5、湿度、以及阴、晴、云、雾、风、霜、雪、雨、雷、电等气候信息,从而应用到自己编写的程序中。
挖数据API接口:
提供天气预报数据接口,数据来源中央气象台天气信息,便捷查询今日天气,周末天气,一周天气预报,蓝天预报,天气预报,40日天气预报,还提供的生活指数、健康指数、交通指数、旅游指数,及时发布鄱阳气象预警信号、各类气象资讯,天气信息。
Api文档:
子接口:
接口地址: https://登录后显示/api/74/187(支持:http/https)
返回格式:json,xml
请求方式:GET,POST
POST 请求需要设置Header头:Content-Type: application/x-www-form-urlencoded;charset=utf-8
请求说明:
名称
必填
类型
说明
示例 参数另存
appid
是
String
应用ID,在后台我的应用查看或者添加
1
format
否
String
返回数据格式类型,每个接口已经说明支持返回格式:json,xml
json
sign
是
String
1.使用Md5方式验证,参数按一定规则md5后返回的字符串,详情点击这里阅读
2.使用Hash验证方式,直接跟上密钥即可。
通过我的应用里面修改验证方式
52a9dbe274a5c537bbf7a53e2d66c09f
time
否
String
请求时传递的当前服务器时间戳
1545829466
wtr_id
是
String
可以是城市名称(厦门)、城市ID(101230201)、城市名全拼
返回参数说明:
名称
必填
类型
说明
示例 参数另存
codeid
否
Integer
状态码,返回10000状态都会进行计费。具体说明可查看状态码说明
10000
curtime
否
String
当前服务器时间戳
1565941300
message
否
String
请求状态说明
操作成功!
retdata
否
Array
回数据集合,可能是数据、对象或者字符串
wr_15day
否
Array
今天以及未来14天天气情况
wr_air
否
String
空气质量
wr_airquality
否
String
wr_aqi
否
String
空气质量指数,范围值请参考PM2.5检测网空气质量新准
wr_aqi_pm25
否
String
空气质量指数,范围值请参考PM2.5检测网空气质量新准
40
wr_city
否
String
城市ID,从这个接口【获取城市名及代码】获取
101230201
wr_cityname
否
String
中文名称
厦门
wr_date
否
String
预报时间
20190830
wr_fc24hour
否
Array
24小时天气预报,仅7天内
wr_hour
否
String
小时
2时
wr_limitnumber
否
String
汽车限号
wr_nameen
否
String
城市拼音或者英文名
xiamen
wr_njd
否
String
能见度
15.55km
wr_qy
否
String
气压
985
wr_rain
否
String
当前降雨量(毫米)
0.0
wr_rain24h
否
String
24小时降雨量
0
wr_richu
否
String
日出时间
05:47
wr_riluo
否
String
日落时间
18:28
wr_sd
否
String
空气温度
68%
wr_temp
否
String
当前温度
26
wr_tempf
否
String
华氏温度
89
wr_time
否
String
预报时间
15:20
wr_today
否
Array
当前天气数据
wr_wd
否
String
风向及等级
南风<3级转西南风<3级
wr_wdcode
否
Array
风向代码,当出现转变风向时,两代码不一致,后面为转变之后的代码 风向代码说明
wr_wde
否
String
风向英文缩写
SE
wr_weather
否
String
天气 天气图标
雨
wr_weathercode
否
Array
天气代码,当出现天气出现变化时,两个代码不一致,后面为转变之后的天气代码天气代码
wr_weathere
否
String
英文天气
Overcast
wr_ws
否
String
风速等级
2级
wr_wscode
否
Array
风速代码,当出现转变风速时,两代码不一致,后面为转变之后的代码 风速代码说明
wr_wse
否
String
风速
<12km/h
状态码说明:
状态码
说明
10000
返回成功
10001
appid必须指定,可以我的应用里面查看
10002
sign值必须指定,加密规则请前往帮助中心查看
10003
sign值验证不通过,加密规则请前往帮助中心查看
10004
时差不能超过10分钟,可以不传递这个参数,注意时间戳单位是秒
10005
appid错误,请检查appid值,前往会员中心->我的应用查看或添加
10006
当前IP地址未授权,请前往用户中心->我的应用添加ip{@info}
10007
应用被禁用,请联系客服处理
10008
应用内没有该接口,请到我的应用里面添加这个接口
10009
api接口不存在
10010
您没有添加该api接口
10011
api已经到期
10012
没有订购任何api,请前往购买后再操作
10013
该接口已经暂停使用
10014
未知的错误,可以联系客服处理
10015
参数个数错误
10019
{@info}
10017
time必须是整型
10018
次数不足
10020
子接口不存在,可能已经被关闭
10021
服务器发生错误
10022
帐户余额不足,请充值!
10023
订单提交成功,等待回调结果
10024
调试模式数据
10025
查无数据
请求示例:
现在越来越多的企业开始使用挖数据提供的天气预报api接口,好用是一方面,功能强大是另一方面,最重要的是大家对挖数据平台的信任和厚爱,相信在不久的将来,天气预报API一定能够给广大用户带来良好、满意的体验!