5分钟更新一次，包含基本天气信息、24小时逐小时天气、实时气象预警列表、湿度、能见度、气压、日出日落、9大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等，可按地名、城市编号、IP查询。
新增：优化预警字段, 返回实时预警数组, 5分钟更新一次数据源, 可同时出现多个预警, 可参考文档下方JSON。
地区权限 |
请求限制 |
使用方案 |
发票 |
|
全国所有市区县 |
每日10万次 |
500/一年(最低) |
2000/永久(最低) |
可提供普票、电子票、专票 |
全国所有市区县 |
每日百万~千万次 |
联系客服开通独享版本，最低12800/年 |
可开普票/电子票/专票 |
|
请求次数限制仅限于单个APPID每日请求次数不超规定范围，并不会限制使用的项目数量、App、设备及IP等。
请求方式及url：
- 请求方式：GET
- 接口地址：(请将线路地址设置在服务端, 为动态可修改的, 如遇ddos攻击, 需更换线路)
- 线路1(推荐)：http://v0.yiketianqi.com/api
- 线路2：http://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 |
是否需要打开净化器 |
