专业天气Pro( 实况+14日逐小时 )
实况数据5分钟更新一次
支持最多14日天气预报
包含每日24小时逐小时预报
每日数据包含:天气情况、高温低温、平均温度、降雨量mm、能见度、湿度、紫外线、日出日落、月出月落
逐小时数据包含:天气情况、温度、风力风向风速、降雨量mm、能见度、湿度、紫外线、气压、云量、空气质量(六因子)、短波太阳辐射、射水平辐射、直接正常辐照度、全球倾斜辐照度
该接口支持经纬度参数查询, 但是需要额外付费
| 免费版 | Pro 版 | 企业版 独享 可定制 |
|---|---|---|
| 3000 次试用 | 每日 5 万次 1000 元/年 |
|
| 每日 10 万次 1500 元/年 | ||
| 每日 50 万次 7500 元/年 | ||
| 每日 100 万次 15000 元/年 | ||
| 每日 500 万次 75000 元/年 | ||
| 缴费5年期可享受85折, 永久使用请联系客服 | ||
| 在线开通 | 联系客服开通 |
GET
接口地址:(请将线路地址设置在服务端, 为动态可修改的, 请勿在C端直连接口, 防止遇到网络问题导致程序异常。)
线路1(推荐):http://proa.tianqiapis.com/
请求示例:
http://proa.tianqiapis.com/?version=v2035&appid=&appsecret=&cityid=101041400&days=14&hour=yes&aqi=yes
请求参数:
| 参数名 | 必选 | 类型 | 说明 | 备注(示例) |
|---|---|---|---|---|
| appid | 是 | string | 用户appid | 注册开发账号 |
| appsecret | 是 | string | 用户appsecret | |
| version | 是 | string | 接口版本标识 | 固定值: v2035
每个接口的version值都不一样
|
| adcode | 否 | string | 国家统计局城市ID | 如:130200000000 请参考 全国统计用区划代码表 |
| cityid | 否 | string | 城市ID | 请参考 城市ID列表 |
| city | 否 | string | 城市名称 | 不要带市和区; 如: 青岛、铁西 |
| province | 否 | string | 所在省 | 如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海 |
| ip | 否 | string | IP地址 | 查询IP所在城市天气 |
| days | 否 | Int | 未来预测天数 | 最多支持14天,传参如: 7, 如果传0, 则只返回实况天气 |
| hour | 否 | String | 是否隐藏小时预报 | 如需显示请传 yes |
| aqi | 否 | String | 是否逐小时空气质量 | 如需显示请传 yes |
| lng | 否 | String | 经度 | 如: 119.545023 (需额外付费开通, 最低档500/年, 2000永久) |
| lat | 否 | String | 纬度 | 如: 36.044254 |
| point | 否 | String | 坐标体系 | 默认百度坐标, 如使用高德坐标, 请传参: gaode |
备注:
cityid、city和ip参数3选一提交,如果不传,默认返回当前ip城市天气,cityid优先级最高。
响应参数说明:
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| updateTime | String | 更新时间 | |
| nums | String | 接口当日请求次数 | |
| city | String | 城市名称 | |
| cityid | String | 城市ID | |
| day | String | 实况天气 | |
| ┗ wea | String | 天气情况 | |
| ┗ wea_img | String | 天气图标 | |
| ┗ tem | String | 实况温度 | |
| ┗ tem_feelslike | String | 体感温度 | |
| ┗ win | String | 风向 | |
| ┗ wind_degree | String | 风向角度 | 范围0~360,0为正北,90为正东, 180为正南,270为正西 |
| ┗ win_meter | String | 风速 | 单位:km/h |
| ┗ win_speed | String | 风力等级 | |
| ┗ air | String | 空气质量 | |
| ┗ air_pm25 | String | pm2.5 | |
| ┗ pressure | String | 气压 | |
| ┗ humidity | String | 湿度 | |
| ┗ vis | String | 能见度 | 单位:km |
| ┗ cloud | String | 云量 | |
| ┗ rain_pcpn | String | 降雨量 | 单位:mm |
| ┗ uv | String | 紫外线 | |
| ┗ uvDesc | String | 紫外线等级描述 | |
| ┗ sunrise | String | 日出时间 | 06:28
|
| ┗ sunset | String | 日落时间 | 19:14
|
| ┗ moonrise | String | 月出时间 | 22:14
|
| ┗ moonset | String | 月落时间 | 11:40
|
| ┗ alarm | String | 气象灾害预警列表 | |
| ┗ ┗ alarm_type | String | 预警类型 | |
| ┗ ┗ alarm_level | String | 预警等级 | 蓝色, 黄色, 橙色, 红色, 白色 |
| ┗ ┗ alarm_title | String | 预警标题 | 如: 天津市滨海新区发布海上大风蓝色预警 |
| ┗ ┗ alarm_content | String | 二氧化氮 | 预警详细内容 |
| month | String | 14日天气 | |
| ┗ date | String | 日期 | |
| ┗ wea | String | 天气情况 | |
| ┗ wea_img | String | 天气情况图标 | |
| ┗ tem_min | String | 低温(夜间温度) | |
| ┗ tem_max | String | 高温(白天温度) | |
| ┗ tem_avg | String | 平均气温 | |
| ┗ rain_pcpn | String | 降雨量 | |
| ┗ vis | String | 能见度 | |
| ┗ humidity | String | 湿度 | |
| ┗ uv | String | 紫外线 | |
| ┗ uvDesc | String | 紫外线等级描述 | |
| ┗ sunrise | String | 日出 | |
| ┗ sunset | String | 日落 | |
| ┗ moonrise | String | 月出 | |
| ┗ moonset | String | 月落 | |
| ┗ hours | String | 24小时预报 | |
| ┗ ┗ time | String | 时间点 | |
| ┗ ┗ wea | String | 天气情况 | |
| ┗ ┗ tem | String | 温度 | |
| ┗ ┗ win | String | 风向 | |
| ┗ ┗ wind_degree | String | 风向角度 | |
| ┗ ┗ win_meter | String | 风速 | |
| ┗ ┗ win_speed | String | 风力等级 | |
| ┗ ┗ pressure | String | 气压 | |
| ┗ ┗ humidity | String | 湿度 | |
| ┗ ┗ vis | String | 能见度 | |
| ┗ ┗ cloud | String | 云量 | |
| ┗ ┗ rain_pcpn | String | 降雨量 | |
| ┗ ┗ uv | String | 紫外线 | |
| ┗ ┗ short_rad | String | 短波太阳辐射或全球水平辐射(GHI) W/m² | |
| ┗ ┗ diff_rad | String | 漫射水平辐射(DHI) W/m² | |
| ┗ ┗ dni | String | 直接正常辐照度(DNI) W/m² | |
| ┗ ┗ gti | String | 全球倾斜辐照度(GTI) W/m² | |
| ┗ ┗ aqi | String | 空气六因子 | 包含:co、no2、o3、so2、pm25、pm10 |
响应JSON:
{
"errcode": 0,
"errmsg": "SUCCESS",
"nums": 10,
"updateTime": "2025-12-15 18:26:18",
"cityid": "101041400",
"city": "涪陵",
"day": {#实况天气
"wea": "多云",#天气情况
"wea_img": "yun",#天气图标
"tem": "10.7",#温度
"tem_feelslike": "13.9",#体感温度
"win": "北风",#风向
"wind_degree": "355",#风向角度
"win_meter": "4",#风速, km/h
"win_speed": "2级", #风力等级
"air": "25",#空气质量
"air_pm25": "20",#pm2.5
"pressure": "1019",#气压
"humidity": "71",#湿度
"vis": "10",#能见度
"cloud": "32",#云量
"rain_pcpn": "2.5",#降雨量,单位mm
"uv": "1.5",#紫外线
"uvDesc": "低",#紫外线等级描述
"sunrise": "07:38",#日出时间
"sunset": "05:53",#日落时间
"moonrise": "03:17",#月出时间
"moonset": "02:28",#月落时间
"alarm": [ #气象预警列表
{
"alarm_type": "海上大风", #预警类型
"alarm_level": "蓝色", #预警等级
"alarm_title": "天津市滨海新区发布海上大风蓝色预警", #预警标题
"alarm_content": "滨海新区气象台于2025年12月15日14时53分发布海上大风蓝色预警信号:预计明天白天,天津港锚地海域、渤海中部海域将有东北风6-7级阵风8级,请有关单位和人员做好防范准备。(预警信息来源:国家预警信息发布中心)" #预警详细内容
},
{
"alarm_type": "海上大风",
"alarm_level": "蓝色",
"alarm_title": "天津市发布海上大风蓝色预警",
"alarm_content": "天津海洋中心气象台于2025年12月15日14时45分发布海上大风蓝色预警信号:预计明天白天,天津港锚地海域、渤海中部海域将有东北风6-7级阵风8级,请有关单位和人员做好防范准备。(预警信息来源:国家预警信息发布中心)"
}
]
},
"month": [ #未来天气 通过days参数控制, 接收值:1-14
{
"date": "2025-12-15",
"wea": "局部多云", #天气情况
"wea_img": "yun",
"tem_min": "13.6", #低温(夜间温度)
"tem_max": "9.5", #高温(白天温度)
"tem_avg": "11.3", #平均温度
"rain_pcpn": "0.2", #降雨量mm
"vis": "10", #能见度km
"humidity": "82", #湿度
"uv": "0.4", #紫外线等级
"uvDesc": "低", #紫外线等级描述
"sunrise": "07:38", #日出时间
"sunset": "05:53", #日落时间
"moonrise": "03:17", #月出时间
"moonset": "02:28" #月落时间
"hours": [ #小时预报, 每日都是从0点开始, 带有时间戳方便截取, 由于内容太多文档里只输出了前两项,其余省略
{
"time": "2025-12-15 00:00", #时间点
"timeUtc": 1765728000, #时间戳
"wea": "晴朗",
"tem": "-1.2",
"win": "西西南风",
"wind_degree": "243",
"win_meter": "7.2",
"win_speed": "",
"pressure": "1022",
"humidity": "56",
"vis": "10",
"cloud": "15",
"rain_pcpn": "0",
"uv": "0",
"uvDesc": "低",
"short_rad": "0", #短波太阳辐射或全球水平辐射(GHI) W/m²
"diff_rad": "0", #漫射水平辐射(DHI) W/m²
"dni": "0", #直接正常辐照度(DNI) W/m²
"gti": "0", #全球倾斜辐照度(GTI) W/m²
"aqi": { #逐小时空气质量六因子
"co": "2586.85",
"no2": "65.45",
"o3": "10",
"so2": "103.35",
"pm25": "114.05",
"pm10": "120.55"
}
},
{
"time": "2025-12-15 01:00",
"timeUtc": 1765731600,
"wea": "局部多云",
"tem": "-1.5",
"win": "西西南风",
"wind_degree": "244",
"win_meter": "6.8",
"win_speed": "",
"pressure": "1022",
"humidity": "58",
"vis": "10",
"cloud": "31",
"rain_pcpn": "0",
"uv": "0",
"uvDesc": "低",
"short_rad": "0",
"diff_rad": "0",
"dni": "0",
"gti": "0",
"aqi": {
"co": "3084.85",
"no2": "73.85",
"o3": "0",
"so2": "118.15",
"pm25": "174.55",
"pm10": "183.85"
}
}
]
},
{
"date": "2025-12-16",
"wea": "局部多云",
"wea_img": "yun",
"tem_min": "12.3",
"tem_max": "9.7",
"tem_avg": "11.1",
"rain_pcpn": "0.04",
"vis": "10",
"humidity": "86",
"uv": "0.2",
"uvDesc": "低",
"sunrise": "07:39",
"sunset": "05:54",
"moonrise": "04:12",
"moonset": "02:59"
},
{
"date": "2025-12-17",
"wea": "局部多云",
"wea_img": "yun",
"tem_min": "16",
"tem_max": "9.7",
"tem_avg": "12.9",
"rain_pcpn": "0.04",
"vis": "10",
"humidity": "80",
"uv": "0.5",
"uvDesc": "低",
"sunrise": "07:39",
"sunset": "05:54",
"moonrise": "05:09",
"moonset": "03:35"
},
{
"date": "2025-12-18",
"wea": "晴天",
"wea_img": "qing",
"tem_min": "18.2",
"tem_max": "11.1",
"tem_avg": "14.3",
"rain_pcpn": "0",
"vis": "10",
"humidity": "71",
"uv": "0.6",
"uvDesc": "低",
"sunrise": "07:40",
"sunset": "05:54",
"moonrise": "06:05",
"moonset": "04:15"
},
{
"date": "2025-12-19",
"wea": "局部多云",
"wea_img": "yun",
"tem_min": "17.6",
"tem_max": "11.8",
"tem_avg": "14.5",
"rain_pcpn": "0",
"vis": "10",
"humidity": "72",
"uv": "0.6",
"uvDesc": "低",
"sunrise": "07:41",
"sunset": "05:55",
"moonrise": "07:02",
"moonset": "05:01"
},
{
"date": "2025-12-20",
"wea": "周边有零星小雨",
"wea_img": "yu",
"tem_min": "13.9",
"tem_max": "12.3",
"tem_avg": "13.1",
"rain_pcpn": "1.48",
"vis": "6",
"humidity": "88",
"uv": "3",
"uvDesc": "中等",
"sunrise": "07:41",
"sunset": "05:55",
"moonrise": "07:56",
"moonset": "05:53"
},
{
"date": "2025-12-21",
"wea": "周边有零星小雨",
"wea_img": "yu",
"tem_min": "11.8",
"tem_max": "11.1",
"tem_avg": "11.5",
"rain_pcpn": "0.2",
"vis": "10",
"humidity": "87",
"uv": "3",
"uvDesc": "中等",
"sunrise": "07:42",
"sunset": "05:56",
"moonrise": "08:46",
"moonset": "06:50"
},
{
"date": "2025-12-22",
"wea": "阴天",
"wea_img": "yin",
"tem_min": "11.6",
"tem_max": "10.2",
"tem_avg": "10.9",
"rain_pcpn": "0.06",
"vis": "10",
"humidity": "80",
"uv": "3",
"uvDesc": "中等",
"sunrise": "07:42",
"sunset": "05:56",
"moonrise": "09:31",
"moonset": "07:49"
},
{
"date": "2025-12-23",
"wea": "周边有零星小雨",
"wea_img": "yu",
"tem_min": "9",
"tem_max": "8.9",
"tem_avg": "9.1",
"rain_pcpn": "0.71",
"vis": "8",
"humidity": "87",
"uv": "2",
"uvDesc": "低",
"sunrise": "07:43",
"sunset": "05:57",
"moonrise": "10:10",
"moonset": "08:49"
},
{
"date": "2025-12-24",
"wea": "周边有零星小雨",
"wea_img": "yu",
"tem_min": "9.3",
"tem_max": "8.9",
"tem_avg": "9.1",
"rain_pcpn": "1.51",
"vis": "5",
"humidity": "92",
"uv": "2",
"uvDesc": "低",
"sunrise": "07:43",
"sunset": "05:57",
"moonrise": "10:45",
"moonset": "09:49"
},
{
"date": "2025-12-25",
"wea": "周边有零星小雨",
"wea_img": "yu",
"tem_min": "9.2",
"tem_max": "8.4",
"tem_avg": "8.8",
"rain_pcpn": "0.65",
"vis": "9",
"humidity": "89",
"uv": "2",
"uvDesc": "低",
"sunrise": "07:43",
"sunset": "05:58",
"moonrise": "11:17",
"moonset": "10:48"
},
{
"date": "2025-12-26",
"wea": "局部多云",
"wea_img": "yun",
"tem_min": "13.3",
"tem_max": "8.9",
"tem_avg": "11",
"rain_pcpn": "0.02",
"vis": "10",
"humidity": "79",
"uv": "4",
"uvDesc": "中等",
"sunrise": "07:44",
"sunset": "05:58",
"moonrise": "11:47",
"moonset": "11:47"
},
{
"date": "2025-12-27",
"wea": "周边有零星小雨",
"wea_img": "yu",
"tem_min": "10.7",
"tem_max": "10.1",
"tem_avg": "10.6",
"rain_pcpn": "0.47",
"vis": "9",
"humidity": "88",
"uv": "3",
"uvDesc": "中等",
"sunrise": "07:44",
"sunset": "05:59",
"moonrise": "12:16",
"moonset": "No mo"
},
{
"date": "2025-12-28",
"wea": "周边有零星小雨",
"wea_img": "yu",
"tem_min": "9.8",
"tem_max": "8.7",
"tem_avg": "9.4",
"rain_pcpn": "2.86",
"vis": "5",
"humidity": "94",
"uv": "2",
"uvDesc": "低",
"sunrise": "07:45",
"sunset": "06:00",
"moonrise": "12:46",
"moonset": "12:48"
}
]
}