5分钟更新一次,包含基本天气信息、小时逐小时天气、实时气象预警列表、湿度、能见度、气压、日出日落、9大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等,可按地名、城市编号、IP查询。
新增:优化预警字段, 返回实时预警数组, 5分钟更新一次数据源, 可同时出现多个预警, 可参考文档下方JSON。
地区权限 | 请求限制 | 使用方案 | 发票 | |
全国所有市区县 | 每日万次 | /一年(最低) | /永久(最低) | 可提供普票、电子票、专票 |
全国所有市区县 | 每日百万~千万次 | 联系客服开通独享版本,最低/年 | 可开普票/电子票/专票 |
请求次数限制仅限于单个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=&appsecret=x8jaKkps??
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
appid | 是 | string | 用户appid | |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: v63每个接口的version值都不一样 |
adcode | 否 | string | 国家统计局城市ID | 如: 请参考 全国统计用区划代码表 |
cityid | 否 | string | 城市ID | 请参考 城市ID列表 |
city | 否 | string | 城市名称 | 不要带市和区; 如: 青岛、铁西 |
province | 否 | string | 所在省 | 如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海 |
ip | 否 | string | IP地址 | 查询IP所在城市天气 |
lng | 否 | String | 经度 | 如: (需额外开通lbs权限, /年, /5年) |
lat | 否 | String | 纬度 | 如: |
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":"",
"date":"",
"week":"星期四",
"update_time":":",
"city":"嘉定",
"cityEn":"jiading",
"country":"中国",
"countryEn":"China",
"wea":"多云",
"wea_img":"yun",
"tem":"",
"tem1":"",
"tem2":"",
"win":"东北风",
"win_speed":"2级",
"win_meter":"7km/h",
"humidity":"%",
"visibility":"30km",
"pressure":"",
"rain_pcpn":"",#降雨量2.5mm
"air":"",
"air_pm25":"",
"air_level":"优",
"air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!",
"alarm":[
{
"alarm_type":"雷电",
"alarm_level":"黄色",
"alarm_title":"上海市嘉定区发布雷电黄色预警",
"alarm_content":"嘉定区气象局年月日时分发布雷电黄色预警[Ⅲ级/较重]:预计今天半夜以前我区将出现雷电活动,局地可能伴有1小时最大雨强-60mm的短时强降水,请加强防范。(预警信息来源:国家预警信息发布中心)"
},
{
"alarm_type":"雷电",
"alarm_level":"黄色",
"alarm_title":"上海市发布雷电黄色预警",
"alarm_content":"上海中心气象台年月日时分发布雷电黄色预警[Ⅲ级/较重]:预计今天半夜以前本市大部地区将出现雷电活动,局地可能伴有1小时最大雨强-60mm的短时强降水,请加强防范。(预警信息来源:国家预警信息发布中心)"
}
],
"wea_day":"小雨",
"wea_day_img":"yu",
"wea_night":"小雨",
"wea_night_img":"yu",
"sunrise":":",
"sunset":":",
"hours":[
{
"hours":"现在",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东南风",
"win_speed":"1级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"1级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"3级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"3级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"/",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"",
"win":"北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"东北风",
"win_speed":"3级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"北风",
"win_speed":"2级",
"vis":"",
"aqi":"优",
"aqinum":""
},
{
"hours":":",
"wea":"小雨",
"wea_img":"yu",
"tem":"",
"win":"北风",
"win_speed":"3级",
"vis":"",
"aqi":"优",
"aqinum":""
}
],
"aqi":{
"update_time":":",
"air":"",
"air_level":"优",
"air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!",
"pm25":"",
"pm25_desc":"优",
"pm10":"",
"pm10_desc":"优",
"o3":"",
"o3_desc":"优",
"no2":"",
"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字段自己处理): |
tem | String | 实时温度 | |
tem1 | String | 高温 | |
tem2 | String | 低温 | |
win | String | 风向 | |
win_speed | String | 风力等级 | |
win_meter | String | 风速 | |
humidity | String | 湿度 | |
visibility | String | 能见度 | |
pressure | String | 气压hPa | |
rain_pcpn | String | 今日降雨量数值 | 例如:, 单位: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 | 是否需要打开净化器 |