天气API接口数据, 数据字段最全,免费,稳定的实况天气预报接口
5分钟左右更新一次,支持全国3000多个市区县, 包含基本天气信息、24小时逐小时天气、气象预警列表、湿度、能见度、气压、降雨量、紫外线、风力风向风速、日出日落、空气质量、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等等,可按地名、城市编号、IP查询、经纬度查询。
看上面的说明, 返回数据够多的吧, 该接口有每日免费次数, 付费最高可每日请求50万次
注意:本文档对接的是天气API的实况天气数据, 如需7日或更多请查看官网文档
接口特点
- 5分钟左右更新一次
- 支持全国所有市区县(3200个左右吧)
- 含24小时天气
- 含气象灾害预警
- 空气六因子
- 支持经纬度查询
- 多线路
对接流程
- 打开并注册天气API平台 (http://tianqiapi.com/) 进入用户中心,获取appid和appsecret
- 阅读实况天气开发文档
http://tianqiapi.com/index/doc?version=2030 - 请求接口
- 解析JSON
Tips:大家在请求这类三方http接口的时候, 请一定将接口地址设置在服务端, 为动态可修改的, 请勿在C端直连接口, 防止遇到网络问题导致程序异常。
请求接口 (appid和appsecret换成自己的)
js
https://v1.yiketianqi.com/free/v2030?appid=85841439&appsecret=EKCDLT4I&adcode=130200000000&aqi=
请求参数
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 先注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
adcode | 否 | string | 国家统计局城市ID | 如:130200000000 请参考 全国统计用区划代码表 |
cityid | 否 | string | 城市ID | 请参考 城市ID列表 |
city | 否 | string | 城市名称 | 不要带市和区; 如: 青岛、铁西 |
province | 否 | string | 所在省 | 如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海 |
ip | 否 | string | IP地址 | 查询IP所在城市天气 |
lng | 否 | String | 经度 | 如: 119.545023 (需额外开通lbs权限) |
lat | 否 | String | 纬度 | 如: 36.044254 |
point | 否 | String | 坐标体系 | 默认百度坐标, 如使用高德坐标, 请传参: gaode |
callback | 否 | string | jsonp参数 | 如: jQuery.Callbacks |
vue | 否 | string | 跨域参数 | 如果您使用的是react、vue、angular请填写值: 1 |
hours | 否 | Int | 是否显示小时天气 | 默认隐藏, 如需显示, 请传参: 1 |
aqi | 否 | Int | 是否显示AQI六因子 | 默认隐藏, 如需显示, 请传参: 1 |
返回JSON内容
javascript
{
"cityid": "101160602",
"date": "2024-02-25",
"week": "星期日",
"update_time": "22:55",
"city": "永昌",
"cityEn": "yongchang",
"country": "中国",
"countryEn": "China",
"wea": "阴",
"wea_img": "yin",
"tem": "-7.5",
"tem1": "-2",
"tem2": "-14",
"win": "东南风",
"win_speed": "2级",
"win_meter": "6km\/h",
"humidity": "94%",//湿度
"visibility": "17km",//能见度
"pressure": "792",//气压
"air": "124",//空气质量
"air_pm25": "124",
"air_level": "轻度污染",
"air_tips": "各类人群可多参加户外活动,多呼吸一下清新的空气。",
"alarm": [
{
"alarm_type": "道路结冰",
"alarm_level": "黄色",
"alarm_title": "甘肃省永昌县发布道路结冰黄色预警",
"alarm_content": "永昌县气象台2024年02月25日21时14分发布道路结冰黄色预警信号:受降雪和低温天气影响,预计未来24小时,我县大部乡镇将出现对交通有影响的道路结冰,请注意防范。(预警信息来源:国家预警信息发布中心)"
},
{
"alarm_type": "道路结冰",
"alarm_level": "黄色",
"alarm_title": "甘肃省金昌市发布道路结冰黄色预警",
"alarm_content": "金昌市气象台2024年02月25日17时02分发布道路结冰黄色预警信号:受降雪和低温天气影响,预计未来24小时,我市部分路段将出现道路结冰,影响交通安全,请注意防范。(预警信息来源:国家预警信息发布中心)"
}
],
"rain_pcpn": "0",//降雨量mm
"uvIndex": "0",//紫外线0-11
"uvDescription": "低",
"wea_day": "阴",//白天天气
"wea_day_img": "yin",
"wea_night": "多云",//夜间天气
"wea_night_img": "yun",
"sunrise": "07:50",//日出
"sunset": "19:00",//日落
"hours": [
{
"hours": "22:00",
"wea": "轻度雾霾",
"wea_img": "wu",
"tem": "-6",
"win": "东北风",
"win_speed": "1级",
"vis": "14.9",//能见度
"aqinum": "114",//aqi
"aqi": "轻度污染"
},
{
"hours": "23:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-6",
"win": "东南风",
"win_speed": "1级",
"vis": "78.06",
"aqinum": "52",
"aqi": "良"
},
{
"hours": "00:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-7",
"win": "东南风",
"win_speed": "无风",
"vis": "80.35",
"aqinum": "50",
"aqi": "优"
},
{
"hours": "01:00",
"wea": "阴",
"wea_img": "yin",
"tem": "-7",
"win": "西南风",
"win_speed": "无风",
"vis": "82.84",
"aqinum": "48",
"aqi": "优"
},
{
"hours": "02:00",
"wea": "阴",
"wea_img": "yin",
"tem": "-7",
"win": "西南风",
"win_speed": "无风",
"vis": "95.67",
"aqinum": "47",
"aqi": "优"
},
{
"hours": "03:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-7",
"win": "东风",
"win_speed": "1级",
"vis": "88.93",
"aqinum": "45",
"aqi": "优"
},
{
"hours": "04:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-8",
"win": "东北风",
"win_speed": "1级",
"vis": "86.09",
"aqinum": "44",
"aqi": "优"
},
{
"hours": "05:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-8",
"win": "风",
"win_speed": "1级",
"vis": "82.28",
"aqinum": "42",
"aqi": "优"
},
{
"hours": "06:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-8",
"win": "西北风",
"win_speed": "1级",
"vis": "85.25",
"aqinum": "41",
"aqi": "优"
},
{
"hours": "07:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-8",
"win": "西北风",
"win_speed": "2级",
"vis": "94.49",
"aqinum": "40",
"aqi": "优"
},
{
"hours": "08:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-8",
"win": "西北风",
"win_speed": "2级",
"vis": "103.71",
"aqinum": "40",
"aqi": "优"
},
{
"hours": "09:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-8",
"win": "西北风",
"win_speed": "2级",
"vis": "177.04",
"aqinum": "38",
"aqi": "优"
},
{
"hours": "10:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-7",
"win": "西北风",
"win_speed": "2级",
"vis": "231.08",
"aqinum": "37",
"aqi": "优"
},
{
"hours": "11:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-6",
"win": "西北风",
"win_speed": "2级",
"vis": "231.08",
"aqinum": "35",
"aqi": "优"
},
{
"hours": "12:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-5",
"win": "西北风",
"win_speed": "2级",
"vis": "231.08",
"aqinum": "32",
"aqi": "优"
},
{
"hours": "13:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-4",
"win": "西北风",
"win_speed": "1级",
"vis": "231.08",
"aqinum": "31",
"aqi": "优"
},
{
"hours": "14:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-3",
"win": "西北风",
"win_speed": "1级",
"vis": "231.08",
"aqinum": "30",
"aqi": "优"
},
{
"hours": "15:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-2",
"win": "东北风",
"win_speed": "2级",
"vis": "231.08",
"aqinum": "33",
"aqi": "优"
},
{
"hours": "16:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-1",
"win": "东北风",
"win_speed": "3级",
"vis": "231.08",
"aqinum": "27",
"aqi": "优"
},
{
"hours": "17:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-2",
"win": "东风",
"win_speed": "3级",
"vis": "231.08",
"aqinum": "25",
"aqi": "优"
},
{
"hours": "18:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-3",
"win": "东南风",
"win_speed": "3级",
"vis": "231.08",
"aqinum": "24",
"aqi": "优"
},
{
"hours": "19:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-5",
"win": "东风",
"win_speed": "3级",
"vis": "231.08",
"aqinum": "22",
"aqi": "优"
},
{
"hours": "20:00",
"wea": "多云",
"wea_img": "yun",
"tem": "-6",
"win": "东风",
"win_speed": "2级",
"vis": "128.67",
"aqinum": "21",
"aqi": "优"
},
{
"hours": "21:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-6",
"win": "东北风",
"win_speed": "2级",
"vis": "120.35",
"aqinum": "21",
"aqi": "优"
},
{
"hours": "22:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-6",
"win": "东北风",
"win_speed": "2级",
"vis": "117.9",
"aqinum": "21",
"aqi": "优"
},
{
"hours": "23:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-7",
"win": "东风",
"win_speed": "1级",
"vis": "97.76",
"aqinum": "21",
"aqi": "优"
},
{
"hours": "00:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-7",
"win": "东北风",
"win_speed": "1级",
"vis": "90.18",
"aqinum": "21",
"aqi": "优"
},
{
"hours": "01:00",
"wea": "晴",
"wea_img": "qing",
"tem": "-7",
"win": "风",
"win_speed": "1级",
"vis": "83.73",
"aqinum": "21",
"aqi": "优"
}
],
"aqi": {
"update_time": "22:30",
"air": "114",
"air_level": "轻度污染",
"air_tips": "各类人群可多参加户外活动,多呼吸一下清新的空气。",
"pm25": "86",
"pm25_desc": "轻度污染",
"pm10": "172",
"pm10_desc": "中度污染",
"o3": "80",
"o3_desc": "",
"no2": "20",
"no2_desc": "",
"so2": "6",
"so2_desc": "",
"co": "0.9",
"co_desc": "",
"kouzhao": "不用佩戴口罩",
"yundong": "适宜运动",
"waichu": "不适宜外出",
"kaichuang": "适宜开窗",
"jinghuaqi": "不需要打开"
},
"nums": 19
}