接口分类
专业实况天气接口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 |
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", "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 }