## 专业实况天气v63接口文档 > 支持全国3200多个市区县, 最快5分钟更新一次,包含基本天气信息、24小时逐小时天气、实时气象预警列表、湿度、能见度、气压、日出日落、9大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等,可按地名、城市编号、IP、经纬度查询。 相比v61增加了:24小时逐小时天气、每小时空气质量、日出日落、白天和晚上天气情况。 > 优化预警字段, 返回实时预警数组, 5分钟更新一次数据源, 可同时出现多个预警, 可参考文档下方JSON。 > 请打开官方文档对接注册账号:https://tianqiapi.com/index/doc?version=v63 > 对接技术支持QQ:445899710 微信号:hype522147 | 地区权限 | 请求限制 | 使用方案 | 发票 | | --- | --- | --- | --- | | 全国所有市区县 | 每日10万次 | 500/一年(最低) | 2000/永久(最低) | 可提供普票、电子票、专票 | | 全国所有市区县 | 每日百万~千万次 | 联系客服开通独享版本,最低12800/年 | 可开普票/电子票/专票 | `请求次数限制仅限于单个APPID每日请求次数不超规定范围,并不会限制使用的项目数量、App、设备及IP等。` **请求方式及url:** * 请求方式:`GET` * **接口地址:(请将线路地址设置为动态可修改的)** * 线路1(推荐):`https://v0.yiketianqi.com/api` * 线路2:`https://yiketianqi.com/api` **请求示例** `https://v0.yiketianqi.com/api?unescape=1&version=v63&appid=43656176&appsecret=I42og6Lm` **请求参数说明:** | 参数名 | 必选 | 类型 | 说明 | 备注(示例) | | --- | --- | --- | --- | --- | | appid | 是 | string | 用户appid | [注册开发账号](https://www.tianqiapi.com/user) | | appsecret | 是 | string | 用户appsecret | | | version | 是 | string | 接口版本标识 | 固定值:`v63`每个接口的version值都不一样 | | cityid | 否 | string | 城市ID | 请参考[城市ID列表](https://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":"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":"关闭净化器" } } ```