> v9升级版，返回数据更简洁, 默认隐藏了生活指数、小时数据和AQI指数, 可自定义展示, 可按地名、城市编号、IP查询、LBS查询。
> 相比v9增加了
>
> * ∞ 实时气象预警列表，可返回已发布的多条预警
> * ∞ 降雨概率百分比，例如：`30%`
> * ∞ 天气情况短语，例如：`大部分地区多云`
> * ∞ 天气情况描述，例如：`中雨。 最高 18ºC。 东北偏北 风 15 到 25 每 km / h 。 降雨几率 70%。 降雨量约 6 mm。`
> * ∞ 紫外线数值，例如：`7、强`
> * ∞ 月出月落及月相，例如：`04:28、残月`
> * ∞ ext参数，默认隐藏了(生活指数、小时数据和AQI指数)，ext传对应标识可自定义输出。
> 详细文档请打开官方文档：http://tianqiapi.com/index/doc?version=v91
> 对接技术支持QQ：445899710 微信号：hype522147
| 地区权限 | 请求限制 | 使用方案(报价为不开票价格) | 发票 |
| --- | --- | --- | --- |
| 全国所有市区县 | 每日2万次 | 350/一年(最低) | 1400/五年(最低) | 2730/永久(最低) | 可开普票/电子票/专票 |
| 全国所有市区县 | 每日5万次 | 400/一年(最低) | 1600/五年(最低) | 3120/永久(最低) | 可开普票/电子票/专票 |
| 全国所有市区县 | 每日10万次 | 550/一年(最低) | 2200/五年(最低) | 4290/永久(最低) | 可开普票/电子票/专票 |
| 全国所有市区县 | 每日20万次 | 1100/一年(最低) | 4400/五年(最低) | 8580/永久(最低) | 可开普票/电子票/专票 |
| 全国所有市区县 | 每日50万次 | 2750/一年(最低) | 11000/五年(最低) | 21450/永久(最低) | 可开普票/电子票/专票 |
| 全国所有市区县 | 每日百万~千万次 | 联系客服开通独享版本，最低12800/年 | 可开普票/电子票/专票 |
> 请求次数限制仅限于单个APPID每日请求次数不超规定范围，并不会限制使用的项目数量、App、设备及IP等。
**请求方式及url：**
* 请求方式：`GET`
* **接口地址：(建议将线路地址设置在服务端可动态修改)**
* 线路1：`http://v1.yiketianqi.com/api`
* 线路2：`http://v0.yiketianqi.com/api`
**请求示例**
`http://v0.yiketianqi.com/api?unescape=1&version=v91&appid=85841439&appsecret=EKCDLT4I&ext=&cityid=`
**请求参数说明：**
| 参数名 | 必选 | 类型 | 说明 | 备注（示例） |
| --- | --- | --- | --- | --- |
| appid | 是 | string | 用户appid | [注册开发账号](http://tianqiapi.com/user) |
| appsecret | 是 | string | 用户appsecret | |
| version | 是 | string | 接口版本标识 | 固定值:`v91`每个接口的version值都不一样 |
| 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/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优先级最高。
**响应参数说明**
| 参数名 | 类型 | 说明 | 备注 |
| --- | --- | --- | --- |
| 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 | 月相 | 例如：19:06 |
| ┗ 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 | 是否需要打开净化器 |
**响应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",
"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":"",
"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":"强"
}
]
}
~~~
