请求方式及url:
-
请求方式:
GET
-
接口地址:(请将线路地址设置在服务端, 为动态可修改的, 请勿在C端直连接口, 防止遇到网络问题导致程序异常。)
- 线路1(推荐):
http://v0.yiketianqi.com/api
- 线路2:
http://v1.yiketianqi.com/api
请求示例
http://v1.yiketianqi.com/api?unescape=1&version=v91&appid=*&appsecret=*&ext=&cityid=
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: v91 每个接口的version值都不一样 |
adcode | 否 | string | 国家统计局城市ID | 如:130200000000 请参考 全国统计用区划代码表 |
cityid | 否 | string | 城市ID | 请参考 城市ID列表 |
city | 否 | string | 城市名称 | 不要带市和区; 如: 青岛、铁西 |
province | 否 | string | 所在省 | 如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海 |
ip | 否 | string | IP地址 | 查询IP所在城市天气 |
ext | 否 | string | 自定义字段参数 | 如: hours,aqi,life (hours:小时天气, life:生活指数, aqi:当日空气质量详情) |
lng | 否 | String | 经度 | 如: 119.545023 (需额外开通lbs权限, 500/年, 2000/永久) |
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":"101050205",
"city":"富裕",
"cityEn":"fuyu",
"country":"中国",
"countryEn":"China",
"update_time":"2021-05-08 21:25:24",
"data":[
{
"day":"08日(星期六)",
"date":"2021-05-08",
"week":"星期六",
"wea":"阴转多云",
"wea_img":"yun",
"wea_day":"阴",
"wea_day_img":"yin",
"wea_night":"多云",
"wea_night_img":"yun",
"tem":"12",
"tem1":"13",
"tem2":"5",
"rain_pcpn":"2.8",#2.8mm
"humidity":"30%",
"visibility":"22.1km",
"pressure":"977",
"win":[
"北风",
"北风"
],
"win_speed":"4-5级转<3级",
"win_meter":"16-24km/h",
"sunrise":"04:13",
"sunset":"19:03",
"air":"15",
"air_level":"优",
"air_tips":"",
"phrase":"多云",
"narrative":"阴。 最高 15ºC。 东北偏北 风 25 到 40 每 km / h 。",
"moonrise":"03:14",
"moonset":"15:18",
"moonPhrase":"残月",
"rain":"0",
"uvIndex":"1",
"uvDescription":"低",
"alarm":[
{
"alarm_type":"大风",
"alarm_level":"蓝色",
"alarm_title":"黑龙江省富裕县发布大风蓝色预警",
"alarm_content":"富裕县气象局2021年5月8日08时50分发布大风蓝色预警信号:未来24小时我县将受大风影响,平均风力5-6级,阵风可达7级,请有关单位和个人注意做好预防工作。(预警信息来源:国家预警信息发布中心)"
},
{
"alarm_type":"大风",
"alarm_level":"蓝色",
"alarm_title":"黑龙江省齐齐哈尔市发布大风蓝色预警",
"alarm_content":"齐齐哈尔市气象台2021年5月8日08时45分发布大风蓝色预警信号:预计未来24小时齐齐哈尔全区将受大风影响,平均风力5-6级,阵风可达7级,请注意预防。(预警信息来源:国家预警信息发布中心)"
}
]
},
{
"day":"09日(星期日)",
"date":"2021-05-09",
"week":"星期日",
"wea":"多云",
"wea_img":"yun",
"wea_day":"多云",
"wea_day_img":"yun",
"wea_night":"多云",
"wea_night_img":"yun",
"tem":"15",
"tem1":"15",
"tem2":"6",
"humidity":"33",
"visibility":"",
"pressure":"",
"rain_pcpn":"0.0",
"win":[
"西北风",
"西南风"
],
"win_speed":"3-4级转<3级",
"win_meter":"",
"sunrise":"04:12",
"sunset":"19:05",
"air":"14",
"air_level":"优",
"air_tips":"",
"phrase":"局部多云",
"narrative":"少云。 最高 17ºC。 北 风 15 到 30 每 km / h 。",
"moonrise":"03:30",
"moonset":"16:22",
"moonPhrase":"残月",
"rain":"0",
"uvIndex":"6",
"uvDescription":"强"
},
{
"day":"10日(星期一)",
"date":"2021-05-10",
"week":"星期一",
"wea":"多云",
"wea_img":"yun",
"wea_day":"多云",
"wea_day_img":"yun",
"wea_night":"多云",
"wea_night_img":"yun",
"tem":"16",
"tem1":"16",
"tem2":"7",
"humidity":"34",
"visibility":"",
"pressure":"",
"win":[
"西北风",
"南风"
],
"win_speed":"<3级",
"win_meter":"",
"sunrise":"04:10",
"sunset":"19:06",
"air":"25",
"air_level":"优",
"air_tips":"",
"phrase":"局部多云",
"narrative":"少云。 最高 20ºC。 南 风 10 到 15 每 km / h 。",
"moonrise":"03:47",
"moonset":"17:28",
"moonPhrase":"残月",
"rain":"8",
"uvIndex":"6",
"uvDescription":"强"
},
{
"day":"11日(星期二)",
"date":"2021-05-11",
"week":"星期二",
"wea":"小雨",
"wea_img":"yu",
"wea_day":"小雨",
"wea_day_img":"yu",
"wea_night":"小雨",
"wea_night_img":"yu",
"tem":"20",
"tem1":"20",
"tem2":"10",
"humidity":"37",
"visibility":"",
"pressure":"",
"win":[
"南风",
"东南风"
],
"win_speed":"<3级",
"win_meter":"",
"sunrise":"04:09",
"sunset":"19:07",
"air":"19",
"air_level":"优",
"air_tips":"",
"phrase":"多云",
"narrative":"阴。 最高 21ºC。 东南偏南 风 25 到 40 每 km / h 。",
"moonrise":"04:05",
"moonset":"18:32",
"moonPhrase":"新月",
"rain":"24",
"uvIndex":"4",
"uvDescription":"中等"
},
{
"day":"12日(星期三)",
"date":"2021-05-12",
"week":"星期三",
"wea":"阵雨转晴",
"wea_img":"yu",
"wea_day":"阵雨",
"wea_day_img":"yu",
"wea_night":"晴",
"wea_night_img":"qing",
"tem":"18",
"tem1":"18",
"tem2":"9",
"humidity":"44",
"visibility":"",
"pressure":"",
"win":[
"西北风",
"西风"
],
"win_speed":"<3级",
"win_meter":"",
"sunrise":"04:07",
"sunset":"19:09",
"air":"12",
"air_level":"优",
"air_tips":"",
"phrase":"局部多云",
"narrative":"少云。 最高 18ºC。 西南偏西 风 25 到 40 每 km / h 。",
"moonrise":"04:26",
"moonset":"19:39",
"moonPhrase":"新月",
"rain":"10",
"uvIndex":"5",
"uvDescription":"中等"
},
{
"day":"13日(星期四)",
"date":"2021-05-13",
"week":"星期四",
"wea":"多云转晴",
"wea_img":"yun",
"wea_day":"多云",
"wea_day_img":"yun",
"wea_night":"晴",
"wea_night_img":"qing",
"tem":"22",
"tem1":"22",
"tem2":"8",
"humidity":"32",
"visibility":"",
"pressure":"",
"win":[
"西风",
"东北风"
],
"win_speed":"<3级",
"win_meter":"",
"sunrise":"04:06",
"sunset":"19:10",
"air":"12",
"air_level":"优",
"air_tips":"",
"phrase":"局部多云",
"narrative":"少云。 最高 23ºC。 西北偏西 风 15 到 25 每 km / h 。",
"moonrise":"04:51",
"moonset":"20:43",
"moonPhrase":"娥眉月",
"rain":"0",
"uvIndex":"6",
"uvDescription":"强"
},
{
"day":"14日(星期五)",
"date":"2021-05-14",
"week":"星期五",
"wea":"阵雨转多云",
"wea_img":"yun",
"wea_day":"阵雨",
"wea_day_img":"yu",
"wea_night":"多云",
"wea_night_img":"yun",
"tem":"16",
"tem1":"16",
"tem2":"9",
"humidity":"39",
"visibility":"",
"pressure":"",
"win":[
"东风",
"东风"
],
"win_speed":"<3级",
"win_meter":"",
"sunrise":"04:05",
"sunset":"19:11",
"air":"8",
"air_level":"优",
"air_tips":"",
"phrase":"局部多云",
"narrative":"少云。 最高 20ºC。 西 风 15 到 30 每 km / h 。",
"moonrise":"05:22",
"moonset":"21:46",
"moonPhrase":"娥眉月",
"rain":"23",
"uvIndex":"6",
"uvDescription":"强"
}
]
}
响应参数说明
参数名 | 类型 | 说明 | 备注 |
---|---|---|---|
cityid | String | 城市ID | |
update_time | String | 气象台更新时间 | |
city | String | 城市名称 | |
cityEn | String | 城市英文名称 | |
country | String | 国家名称 | |
countryEn | String | 国家英文名称 | |
data | String | 每日数据列表 | 1-7日,共7组 |
┗ wea | String | 天气情况1 | |
┗ wea_img | String | 天气对应图标 | 固定9种类型(您也可以根据wea字段自己处理): xue、lei、shachen、wu、bingbao、yun、yu、yin、qing |
┗ phrase | String | 天气情况短语 | 例如:短时阵雨 |
┗ narrative | String | 天气情况描述 | 例如:少许阵雨。 最高 24ºC。 东北偏东 风 10 到 15 每 km / h 。 降雨几率 30%。 |
┗ tem | String | 实时温度 | |
┗ tem1 | String | 高温 | |
┗ tem2 | String | 低温 | |
┗ win | String | 风向 | |
┗ win_speed | String | 风力等级 | |
┗ humidity | String | 湿度 | |
┗ sunrise | String | 日出 | 例如:06:30 |
┗ sunset | String | 日出 | 例如:17:30 |
┗ moonrise | String | 月出 | 例如:05:09 |
┗ moonset | String | 月落 | 例如:19:06 |
┗ moonPhrase | String | 月相 | 例如:娥眉月 |
┗ rain_pcpn | String | 降雨量数值 | 例如:2.5, 单位:mm |
┗ visibility | String | 能见度 | |
┗ pressure | String | 气压hPa | |
┗ air | String | 空气质量 | |
┗ air_level | String | 空气质量等级 | 优,良,轻度污染,中度污染,重度污染,严重污染 |
┗ air_tips | String | 空气质量描述(已废弃) | |
┗ rain | String | 降雨概率 | 例如:15,表示降雨概率15% |
┗ uvIndex | String | 紫外线等级 | 例如:5 |
┗ uvDescription | String | 紫外线等级描述 | 例如:中等 |
┗ alarm[] | String | 气象预警列表 | |
┗ alarm_type | String | 预警类型 | |
┗ alarm_level | String | 预警级别 | |
┗ alarm_level | String | 预警详细信息 | |
┗ hours | String | 小时预报 | |
┗ hours | String | 时间点 | 例如:20时 |
┗ wea | String | 天气 | |
┗ wea_img | String | 天气图标 | |
┗ tem | String | 温度 | |
┗ win | String | 风向 | |
┗ win_speed | String | 风力等级 | |
┗ index | String | 生活指数 | |
┗ title | String | 指数类型 | 例如:穿衣指数 |
┗ level | String | 级别 | 例如:较冷 |
┗ desc | 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 | 是否需要打开净化器 |