5分钟更新一次,包含基本天气信息、24小时逐小时天气、实时气象预警列表、湿度、能见度、气压、日出日落、9大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等,可按地名、城市编号、IP查询。
相比v61增加了:24小时逐小时天气、每小时空气质量、日出日落、白天和晚上天气情况。相比v62去掉了:9大常用生活指数数据。新增:优化预警字段, 返回实时预警数组, 5分钟更新一次数据源, 可同时出现多个预警, 可参考文档下方JSON。
地区权限 | 请求限制 | 使用方案 | 发票 | |
---|---|---|---|---|
全国所有市区县 | 每日10万次 | 500/一年(最低) | 2000/永久(最低) | 可提供普票、电子票、专票 |
全国所有市区县 | 每日百万~千万次 | 联系客服开通独享版本,最低12800/年 | 可开普票/电子票/专票 |
请求次数限制仅限于单个APPID每日请求次数不超规定范围,并不会限制使用的项目数量、App、设备及IP等。
请求方式及url:
请求方式:GET
接口地址:(请将线路地址设置为动态可修改的)
https://v0.yiketianqi.com/api
https://v1.yiketianqi.com/api
线路4:https://yiketianqi.com/api
请求示例
https://v0.yiketianqi.com/api?unescape=1&version=v63&appid=&appsecret=
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: v63 每个接口的version值都不一样
|
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",
"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级",
"aqi":"优",
"aqinum":""
},
{
"hours":"12:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"13:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东北风",
"win_speed":"1级",
"aqi":"优",
"aqinum":""
},
{
"hours":"14:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"15:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"16:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"28",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"17:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"27",
"win":"东北风",
"win_speed":"3级",
"aqi":"优",
"aqinum":""
},
{
"hours":"18:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"27",
"win":"东北风",
"win_speed":"3级",
"aqi":"优",
"aqinum":""
},
{
"hours":"19:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"27",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"20:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"26",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"21:00",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"26",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"22:00",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"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级",
"aqi":"优",
"aqinum":""
},
{
"hours":"01:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"02:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"03:00",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"25",
"win":"北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"04:00",
"wea":"阴转多云",
"wea_img":"yun",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"05:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"东北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"06:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"东北风",
"win_speed":"3级",
"aqi":"优",
"aqinum":""
},
{
"hours":"07:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"08:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"25",
"win":"北风",
"win_speed":"2级",
"aqi":"优",
"aqinum":""
},
{
"hours":"09:00",
"wea":"小雨",
"wea_img":"yu",
"tem":"26",
"win":"北风",
"win_speed":"3级",
"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":"关闭净化器"
}
}