## 专业实况天气接口文档
> 支持全国3200多个市区县, 行政中心5分钟更新一次, 其余城市25分钟更新一次,包含基本天气信息、气象预警、湿度、能见度、气压、日出日落、6大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等,可按地名、城市编号、IP查询。
> 详细文档请打开官方文档:http://tianqiapi.com/index/doc?version=v61
> 对接技术支持QQ:445899710 微信号:hype522147
| 地区权限 | 请求限制 | 使用方案 | 发票 |
| --- | --- | --- | --- |
| 全国所有市区县 | 每日10万次 | 365/一年(最低) | 1500/永久(最低) | 可提供普票、电子票、专票 |
| 全国所有市区县 | 每日百万~千万次 | 联系客服开通独享版本,最低12800/年 | 可开普票/电子票/专票 |
> 请求次数限制仅限于单个APPID每日请求次数不超规定范围,并不会限制使用的项目数量、App、设备及IP等。
**请求方式及url:**
* 请求方式:`GET`
* **接口地址:(请将线路地址设置为动态可修改的)**
* 线路1:`http://v0.yiketianqi.com/api`
* 线路2:`http://v1.yiketianqi.com/api`
**请求示例**
`https://v0.yiketianqi.com/api?unescape=1&version=v61&appid=85841439&appsecret=EKCDLT4I`
**请求参数说明:**
| 参数名 | 必选 | 类型 | 说明 | 备注(示例) |
| --- | --- | --- | --- | --- |
| appid | 是 | string | 用户appid | [注册开发账号](http://tianqiapi.com/user) |
| appsecret | 是 | string | 用户appsecret | |
| version | 是 | string | 接口版本标识 | 固定值:`v61`每个接口的version值都不一样 |
| cityid | 否 | string | 城市ID | 请参考[城市ID列表](http://yikeapi.com/help/tianqicity) |
| 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优先级最高。
**返回结果**
```
{
"cityid":"101271201", #城市编号
"date":"2020-07-15",
"week":"星期三",
"update_time":"10:15", #更新时间
"city":"内江", #城市名称
"cityEn":"neijiang",
"country":"中国",
"countryEn":"China",
"wea":"阴", #实时天气情况
"wea_img":"yin",
"tem":"25", #实时温度
"tem1":"29", #高温
"tem2":"23", #低温
"win":"西风", #风向
"win_speed":"2级", #风力等级
"win_meter":"小于12km/h", #风速
"humidity":"97%", #湿度
"visibility":"24.22km", #能见度
"pressure":"961", #气压
"air":"15", #空气质量
"air_pm25":"8", #pm2.5
"air_level":"优",
"air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!",
"alarm":{
"alarm_type":"暴雨", #预警类型
"alarm_level":"橙色", #预警等级
"alarm_content":"内江市气象台7月15日5时23分发布第16号暴雨橙色预警信号:
预计我市市中区部分地方3小时降雨量将达50毫米以上,并伴有雷电和阵性大风,请加强防范强降水、雷电和大风等带来的危害。
(预警信息来源:国家预警信息发布中心)" #预警描述
},
"aqi":{ #空气质量指数详情
"air":"15",
"air_level":"优",
"air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!",
"pm25":"8",
"pm25_desc":"优",
"pm10":"10",
"pm10_desc":"优",
"o3":"47",
"o3_desc":"优",
"no2":"12",
"no2_desc":"优",
"so2":"8",
"so2_desc":"优",
"co": "1",
"co_desc": "优",
"kouzhao":"无需戴口罩",
"waichu":"适宜外出",
"yundong":"适宜运动",
"kaichuang":"适宜开窗",
"jinghuaqi":"关闭净化器",
"cityid":"101271201",
"city":"内江",
"cityEn":"neijiang",
"country":"中国",
"countryEn":"China"
}
}
```