5分钟更新一次,包含基本天气信息、24小时逐小时天气、实时气象预警列表、湿度、能见度、气压、日出日落、9大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等,可按地名、城市编号、IP查询。
新增:优化预警字段, 返回实时预警数组, 5分钟更新一次数据源, 可同时出现多个预警, 可参考文档下方JSON。
地区权限
请求限制
使用方案
发票
全国所有市区县
每日10万次
500/一年(最低)
2000/永久(最低)
可提供普票、电子票、专票
全国所有市区县
每日百万~千万次
联系客服开通独享版本,最低12800/年
可开普票/电子票/专票
请求次数限制仅限于单个APPID每日请求次数不超规定范围,并不会限制使用的项目数量、App、设备及IP等。
请求方式及url:
- 请求方式:GET
- 接口地址:****(请将线路地址设置在服务端, 为动态可修改的, 如遇ddos攻击, 需更换线路)
- 线路1(推荐):v0.yiketianqi.com/api
- 线路2:v1.yiketianqi.com/api
请求示例
http://v1.yiketianqi.com/api?unescape=1&version=v63&appid=83815731&appsecret=x8jaKkps
请求参数说明:
参数名
必选
类型
说明
备注(示例)
appid
是
string
用户appid
appsecret
是
string
用户appsecret
version
是
string
接口版本标识
固定值: v63每个接口的version值都不一样
adcode
否
string
国家统计局城市ID
如:130200000000 请参考 全国统计用区划代码表
cityid
否
string
城市ID
请参考 城市ID列表
city
否
string
城市名称
不要带市和区; 如: 青岛、铁西
province
否
string
所在省
如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海
ip
否
string
IP地址
查询IP所在城市天气
lng
否
String
经度
如: 119.545023 (需额外开通lbs权限, 500/年, 2000/5年)
lat
否
String
纬度
如: 36.044254
point
否
String
坐标体系
默认百度坐标, 如使用高德坐标, 请传参: gaode
callback
否
string
jsonp参数
如: jQuery.Callbacks
vue
否
string
跨域参数
如果您使用的是react、vue、angular请填写值: 1
unescape
否
Int
是否转义中文
如果您希望json不被unicode, 直接输出中文, 请传此参数: 1
备注
cityid、city和ip参数3选一提交,如果不传,默认返回当前ip城市天气,cityid优先级最高。
响应JSON
{
"cityid":"101020500",
"date":"2021-08-12",
"week":"星期四",
"update_time":"11:18",
"city":"嘉定",
"cityEn":"jiading",
"country":"中国",
"countryEn":"China",
"wea":"多云",
"wea_img":"yun",
"tem":"30",
"tem1":"28",
"tem2":"25",
"win":"东北风",
"win_speed":"2级",
"win_meter":"7km/h",
"humidity":"74%",
"visibility":"30km",
"pressure":"1006",
"rain_pcpn":"2.5",#降雨量2.5mm
"air":"42",
"air_pm25":"14",
"air_level":"优",
"air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!",
"alarm":[
{
"alarm_type":"雷电",
"alarm_level":"黄色",
"alarm_title":"上海市嘉定区发布雷电黄色预警",
"alarm_content":"嘉定区气象局2021年08月12日11时05分发布雷电黄色预警[Ⅲ级/较重]:预计今天半夜以前我区将出现雷电活动,局地可能伴有1小时最大雨强40-60mm的短时强降水,请加强防范。(预警信息来源:国家预警信息发布中心)"
},
{
"alarm_type":"雷电",
"alarm_level":"黄色",
"alarm_title":"上海市发布雷电黄色预警",
"alarm_content":"上海中心气象台2021年08月12日11时00分发布雷电黄色预警[Ⅲ级/较重]:预计今天半夜以前本市大部地区将出现雷电活动,局地可能伴有1小时最大雨强40-60mm的短时强降水,请加强防范。(预警信息来源:国家预警信息发布中心)"
}
],
"wea_day":"小雨",
"wea_day_img":"yu",
"wea_night":"小雨",
"wea_night_img":"yu",
"sunrise":"05:17",
"sunset":"18:42",
"hours":[
{
"hours":"现在",
"wea":"小雨",
"wea_img":"yu",
"tem":"27",
"win":"东南风",
"win_speed":"1级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"12:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东风",
"win_speed":"2级",
"vis":"14.5",
"aqi":"优",
"aqinum":""
},
{
"hours":"13:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东北风",
"win_speed":"1级",
"vis":"13",
"aqi":"优",
"aqinum":""
},
{
"hours":"14:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"15:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"16:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"17:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"27",
"win":"东北风",
"win_speed":"3级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"18:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"27",
"win":"东北风",
"win_speed":"3级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"19:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"27",
"win":"东北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"20:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"26",
"win":"东北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"21:00",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"26",
"win":"东北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"22:00",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"23:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"08/13",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"01:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"02:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"03:00",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"25",
"win":"北风",
"win_speed":"2级",
"vis":"16",
"aqi":"优",
"aqinum":""
},
{
"hours":"04:00",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"vis":"13",
"aqi":"优",
"aqinum":""
},
{
"hours":"05:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"vis":"13.4",
"aqi":"优",
"aqinum":""
},
{
"hours":"06:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"东北风",
"win_speed":"3级",
"vis":"13.5",
"aqi":"优",
"aqinum":""
},
{
"hours":"07:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"北风",
"win_speed":"2级",
"vis":"13.6",
"aqi":"优",
"aqinum":""
},
{
"hours":"08:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"北风",
"win_speed":"2级",
"vis":"13",
"aqi":"优",
"aqinum":""
},
{
"hours":"09:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"26",
"win":"北风",
"win_speed":"3级",
"vis":"13",
"aqi":"优",
"aqinum":""
}
],
"aqi":{
"update_time":"10:29",
"air":"42",
"air_level":"优",
"air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!",
"pm25":"14",
"pm25_desc":"优",
"pm10":"42",
"pm10_desc":"优",
"o3":"23",
"o3_desc":"优",
"no2":"45",
"no2_desc":"优",
"so2":"2",
"so2_desc":"优",
"co":"-",
"co_desc":"-",
"kouzhao":"不用佩戴口罩",
"yundong":"非常适宜运动",
"waichu":"适宜外出",
"kaichuang":"适宜开窗",
"jinghuaqi":"关闭净化器"
}
}
响应参数说明
参数名
类型
说明
备注
cityid
String
城市ID
date
String
当前日期
week
String
当前星期
update_time
String
气象台更新时间
city
String
城市名称
cityEn
String
城市英文名称
country
String
国家名称
countryEn
String
国家英文名称
wea
String
天气情况
wea_img
String
天气对应图标
固定9种类型(您也可以根据wea字段自己处理):
xue、lei、shachen、wu、bingbao、yun、yu、yin、qing
tem
String
实时温度
tem1
String
高温
tem2
String
低温
win
String
风向
win_speed
String
风力等级
win_meter
String
风速
humidity
String
湿度
visibility
String
能见度
pressure
String
气压hPa
rain_pcpn
String
今日降雨量数值
例如:2.5, 单位:mm
air
String
空气质量
air_level
String
空气质量等级
优,良,轻度污染,中度污染,重度污染,严重污染
air_tips
String
空气质量描述
alarm
String
气象预警
┗ alarm_type
String
预警类型
┗ alarm_level
String
预警级别
┗ alarm_level
String
预警详细信息
aqi
String
空气质量指数
┗ air
String
空气质量
┗ air_level
String
空气质量等级
┗ air_tips
String
空气质量提示
┗ pm25
String
PM2.5
┗ pm25_desc
String
PM2.5等级描述
┗ pm10
String
PM10
┗ pm10_desc
String
PM10等级描述
┗ o3
String
o3
┗ o3_desc
String
o3等级描述
┗ no2
String
no2
┗ no2_desc
String
no2等级描述
┗ so2
String
so2
┗ so2_desc
String
so2等级描述
┗ kouzhao
String
是否需要带口罩
┗ waichu
String
外出适宜
┗ kaichuang
String
开窗适宜
┗ jinghuaqi
String
是否需要打开净化器