接口分类
专业实况天气接口v63
5分钟更新一次，包含基本天气信息、24小时逐小时天气、实时气象预警列表、紫外线、降雨量、湿度、能见度、气压、日出日落、9大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等，可按地名、城市编号、IP查询。
相比v61增加了：24小时逐小时天气、每小时空气质量、日出日落、白天和晚上天气情况。
相比v62去掉了：9大常用生活指数数据。
新增：优化预警字段, 返回实时预警数组, 5分钟更新一次数据源, 可同时出现多个预警,
可参考文档下方JSON。
| 地区权限 | 请求限制 | 使用方案 | 发票 | |
|---|---|---|---|---|
| 全国所有市区县 | 每日10万次 | 500/一年(最低) | 2000/永久(最低) | 可提供普票/专票 |
| 全国所有市区县 | 每日百万~千万次 | 联系客服开通独享版本，最低7800/年 | 可开普票/专票 | |
请求次数限制仅限于单个APPID每日请求次数不超规定范围，并不会限制使用的项目数量、App、设备及IP等。
请求方式：
GET
接口地址：(请将线路地址设置在服务端, 为动态可修改的, 请勿在C端直连接口, 防止遇到网络问题导致程序异常。)
线路1(推荐)：http://gfeljm.tianqiapi.com/api
请求示例：
http://gfeljm.tianqiapi.com/api?unescape=1&version=v63&appid=&appsecret=
请求参数：
| 参数名 | 必选 | 类型 | 说明 | 备注（示例） |
|---|---|---|---|---|
| appid | 是 | string | 用户appid | 注册开发账号 |
| appsecret | 是 | string | 用户appsecret | |
| version | 是 | string | 接口版本标识 | 固定值: v63
每个接口的version值都不一样
|
| adcode | 否 | string | 国家统计局城市ID | 如：130200000000 请参考 全国统计用区划代码表 |
| cityid | 否 | string | 城市ID | 请参考 城市ID列表 |
| city | 否 | string | 城市名称 | 不要带市和区; 如: 青岛、铁西 |
| province | 否 | string | 所在省 | 如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海 |
| ip | 否 | string | IP地址 | 查询IP所在城市天气 |
| lng | 否 | String | 经度 | 如: 119.545023 (需额外付费开通, 500/年, 1500永久) |
| lat | 否 | String | 纬度 | 如: 36.044254 |
| point | 否 | String | 坐标体系 | 默认百度坐标, 如使用高德坐标, 请传参: gaode |
| life | 否 | String | 是否展示生活指数 | 不为空为展示, 如: 1 |
| hours | 否 | String | 是否隐藏小时预报 | 不为空为隐藏, 如: 1 |
| callback | 否 | string | jsonp参数 | 如:
jQuery.Callbacks |
| vue | 否 | string | 跨域参数 |
如果您使用的是react、vue、angular请填写值: 1 |
| unescape | 否 | Int | 是否转义中文 | 如果您希望json不被unicode,
直接输出中文, 请传此参数: 1 |
备注：
cityid、city和ip参数3选一提交，如果不传，默认返回当前ip城市天气，cityid优先级最高。
响应JSON：
{
"cityid": "101070901",
"date": "2025-08-13",
"week": "星期三",
"update_time": "16:16", #更新时间
"city": "阜新", #城市名称
"cityEn": "fuxin",
"country": "中国",
"countryEn": "China",
"wea": "多云", #天气情况
"wea_img": "yun", #天气图标
"tem": "26.8", #实况温度
"tem1": "27", #高温(白天温度)
"tem2": "16", #低温(夜间温度)
"win": "西南风", #风向
"win_speed": "3级", #风力
"win_meter": "15km\/h", #风速
"humidity": "66%", #湿度
"visibility": "30km", #能见度
"pressure": "988", #气压
"air": "39", #空气质量
"air_pm25": "10", #pm2.5
"air_level": "优", #空气质量等级
"air_tips": "空气质量令人满意，基本无空气污染。",
"alarm": [ #气象预警列表
{
"alarm_type": "雷电", #预警类型
"alarm_level": "黄色", #预警级别
"alarm_title": "辽宁省阜新市发布雷电黄色预警", #预警标题
"alarm_content": "继续发布雷电黄色预警信号：预计13日白天，阜新市区将出现雷电天气，同时可能伴有短时大风、冰雹、短时强降水等强对流天气，请不要在树下、电杆下、塔吊下避雨，尽量避免户外活动。阜新市气象台2025年08月13日08时08分发布（预警信息来源：国家预警信息发布中心）" #预警内容
},
{
"alarm_type": "雷电",
"alarm_level": "黄色",
"alarm_title": "辽宁省阜新市发布雷电黄色预警",
"alarm_content": "继续发布雷电黄色预警信号：预计13日白天，阜新市区将出现雷电天气，同时可能伴有短时大风、冰雹、短时强降水等强对流天气，请不要在树下、电杆下、塔吊下避雨，尽量避免户外活动。阜新市气象台2025年08月13日08时08分发布（预警信息来源：国家预警信息发布中心）"
}
],
"rain_pcpn": "6.7", #降雨量数值
"uvIndex": "6", #紫外线
"uvDescription": "强",
"wea_day": "小到中雨", #白天天气情况
"wea_day_img": "yu",
"wea_night": "晴", #夜间天气情况
"wea_night_img": "qing",
"sunrise": "04:59", #日出时间
"sunset": "18:57", #日落时间
"hours": [
{
"hours": "17:00",
"wea": "晴",
"wea_img": "qing",
"tem": "26", #温度
"win": "西南风",
"win_speed": "3级",
"vis": "19.05", #能见度
"aqinum": "37", #空气质量
"aqi": "优"
},
{
"hours": "18:00",
"wea": "晴",
"wea_img": "qing",
"tem": "25",
"win": "西南风",
"win_speed": "1级",
"vis": "20.01",
"aqinum": "36",
"aqi": "优"
},
{
"hours": "19:00",
"wea": "多云",
"wea_img": "yun",
"tem": "23",
"win": "西南风",
"win_speed": "1级",
"vis": "18.83",
"aqinum": "35",
"aqi": "优"
},
{
"hours": "20:00",
"wea": "多云",
"wea_img": "yun",
"tem": "23",
"win": "西南风",
"win_speed": "1级",
"vis": "15.65",
"aqinum": "34",
"aqi": "优"
},
{
"hours": "21:00",
"wea": "晴",
"wea_img": "qing",
"tem": "22",
"win": "西南风",
"win_speed": "1级",
"vis": "9.73",
"aqinum": "32",
"aqi": "优"
},
{
"hours": "22:00",
"wea": "晴",
"wea_img": "qing",
"tem": "22",
"win": "西风",
"win_speed": "1级",
"vis": "9.69",
"aqinum": "30",
"aqi": "优"
},
{
"hours": "23:00",
"wea": "晴",
"wea_img": "qing",
"tem": "21",
"win": "西南风",
"win_speed": "1级",
"vis": "9.86",
"aqinum": "31",
"aqi": "优"
},
{
"hours": "00:00",
"wea": "多云",
"wea_img": "yun",
"tem": "21",
"win": "西南风",
"win_speed": "1级",
"vis": "8.89",
"aqinum": "31",
"aqi": "优"
},
{
"hours": "01:00",
"wea": "晴",
"wea_img": "qing",
"tem": "20",
"win": "西南风",
"win_speed": "1级",
"vis": "10.09",
"aqinum": "30",
"aqi": "优"
},
{
"hours": "02:00",
"wea": "晴",
"wea_img": "qing",
"tem": "20",
"win": "西南风",
"win_speed": "1级",
"vis": "16.87",
"aqinum": "29",
"aqi": "优"
},
{
"hours": "03:00",
"wea": "晴",
"wea_img": "qing",
"tem": "20",
"win": "西南风",
"win_speed": "2级",
"vis": "24.91",
"aqinum": "29",
"aqi": "优"
},
{
"hours": "04:00",
"wea": "晴",
"wea_img": "qing",
"tem": "19",
"win": "西南风",
"win_speed": "2级",
"vis": "29.95",
"aqinum": "29",
"aqi": "优"
},
{
"hours": "05:00",
"wea": "晴",
"wea_img": "qing",
"tem": "19",
"win": "西南风",
"win_speed": "2级",
"vis": "27.89",
"aqinum": "29",
"aqi": "优"
},
{
"hours": "06:00",
"wea": "晴",
"wea_img": "qing",
"tem": "20",
"win": "西南风",
"win_speed": "2级",
"vis": "25.05",
"aqinum": "29",
"aqi": "优"
},
{
"hours": "07:00",
"wea": "晴",
"wea_img": "qing",
"tem": "21",
"win": "西南风",
"win_speed": "2级",
"vis": "24.45",
"aqinum": "30",
"aqi": "优"
},
{
"hours": "08:00",
"wea": "晴",
"wea_img": "qing",
"tem": "23",
"win": "西南风",
"win_speed": "2级",
"vis": "29.08",
"aqinum": "33",
"aqi": "优"
},
{
"hours": "09:00",
"wea": "晴",
"wea_img": "qing",
"tem": "24",
"win": "西南风",
"win_speed": "3级",
"vis": "33.36",
"aqinum": "37",
"aqi": "优"
},
{
"hours": "10:00",
"wea": "晴",
"wea_img": "qing",
"tem": "26",
"win": "西南风",
"win_speed": "3级",
"vis": "38.61",
"aqinum": "39",
"aqi": "优"
},
{
"hours": "11:00",
"wea": "晴",
"wea_img": "qing",
"tem": "27",
"win": "西南风",
"win_speed": "3级",
"vis": "37.95",
"aqinum": "39",
"aqi": "优"
},
{
"hours": "12:00",
"wea": "晴",
"wea_img": "qing",
"tem": "28",
"win": "西南风",
"win_speed": "3级",
"vis": "34.38",
"aqinum": "40",
"aqi": "优"
},
{
"hours": "13:00",
"wea": "晴",
"wea_img": "qing",
"tem": "29",
"win": "西南风",
"win_speed": "3级",
"vis": "34.63",
"aqinum": "43",
"aqi": "优"
},
{
"hours": "14:00",
"wea": "多云",
"wea_img": "yun",
"tem": "29",
"win": "西南风",
"win_speed": "2级",
"vis": "32.02",
"aqinum": "44",
"aqi": "优"
},
{
"hours": "15:00",
"wea": "多云",
"wea_img": "yun",
"tem": "29",
"win": "西风",
"win_speed": "2级",
"vis": "31.1",
"aqinum": "45",
"aqi": "优"
},
{
"hours": "16:00",
"wea": "晴",
"wea_img": "qing",
"tem": "29",
"win": "西南风",
"win_speed": "4级",
"vis": "22.03",
"aqinum": "44",
"aqi": "优"
},
{
"hours": "17:00",
"wea": "小雨",
"wea_img": "yu",
"tem": "28",
"win": "西南风",
"win_speed": "3级",
"vis": "21.43",
"aqinum": "44",
"aqi": "优"
}
],
"aqi": {
"update_time": "16:24",
"cityid": "101070901",
"city": "阜新市",
"cityEn": "",
"country": "",
"countryEn": "",
"air": "39",
"air_level": "优",
"air_tips": "空气质量令人满意，基本无空气污染。",
"pm25": "10",
"pm25_desc": "优",
"pm10": "27",
"pm10_desc": "优",
"o3": "122",
"o3_desc": "",
"no2": "7",
"no2_desc": "",
"so2": "6",
"so2_desc": "",
"co": "0.4",
"co_desc": "",
"kouzhao": "不用佩戴口罩",
"yundong": "适宜运动",
"waichu": "适宜外出",
"kaichuang": "适宜开窗",
"jinghuaqi": "不需要打开"
},
"nums": 3 #接口当日请求次数
}