接口分类

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