天气 API - 对接简单更实用
接口文档 http://tianqiapi.com/index/doc?version=2030
返回格式
{
"cityid": "101071401",
"date": "2024-03-13",
"week": "星期三",
"update_time": "21:49",
"city": "葫芦岛",
"cityEn": "huludao",
"country": "中国",
"countryEn": "China",
"wea": "晴",
"wea_img": "qing",
"tem": "3.7",
"tem1": "14",
"tem2": "-3",
"win": "西南风",
"win_speed": "2级",
"win_meter": "9km\/h",
"humidity": "34%",
"visibility": "9km",
"pressure": "1014",
"air": "115",
"air_pm25": "115",
"air_level": "良",
"air_tips": "各类人群可多参加户外活动,多呼吸一下清新的空气。",
"alarm": [
{
"alarm_type": "大风",
"alarm_level": "蓝色",
"alarm_title": "辽宁省葫芦岛市发布大风蓝色预警",
"alarm_content": "大风蓝色预警信号:预计14日8时到20时,龙港区西南风4到6级,阵风7级,渤海北部海域西南风5到6级,阵风7到8级,请注意防范大风对户外、水上、高空作业和出行带来的不利影响。葫芦岛市气象台2024年03月13日15时44分发布(预警信息来源:国家预警信息发布中心)"
}
],
"rain_pcpn": "0",
"uvIndex": "0",
"uvDescription": "低",
"wea_day": "阴",
"wea_day_img": "yin",
"wea_night": "晴",
"wea_night_img": "qing",
"sunrise": "06:11",
"sunset": "18:01",
"nums": 5
}
注意:
cityid、adcode、city、经纬度和ip参数5选一提交即可,如果不传,默认返回当前ip城市天气,cityid优先级最高。
对接流程
- 打开并注册天气API平台 (http://tianqiapi.com/) 进入用户中心,获取appid和appsecret
- 阅读实况天气开发文档
- 请求接口
- 解析JSON
Tips:大家在请求这类三方http接口的时候, 请一定将接口地址设置在服务端, 为动态可修改的, 请勿在C端直连接口, 防止遇到网络问题导致程序异常。
请求接口 (appid和appsecret换成自己的)
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 |