天气预报查询
查询天气情况：温度、湿度、AQI、天气、风向等。
600次/月
普通会员
30000次/月
白银会员
1000000次/月
钻石会员
不限调用量
钻石会员PLUS
立即申请
免费测试
产品介绍
API文档
错误码参照
调试工具
根据城市查询天气
根据城市查询生活指数
天气种类列表
支持城市列表
接口地址：http://api.tanshuapi.com/api/weather/v1/index
返回格式：json
请求方式：不限
请求示例：http://api.tanshuapi.com/api/weather/v1/index?key=&city=1
接口备注：
请求参数说明:
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| key | 是 | string | 个人中心查看 |
| city | 是 | string | 查询的城市名称或者城市id |
返回参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| city | string | 城市名称 |
| realtime | object | 当前天气详情情况 |
| info | string | 天气情况，如：晴、多云 |
| wid | string | 天气标识id，可参考 天气种类列表 接口 |
| temperature | string | 温度 |
| humidity | string | 湿度 |
| direct | string | 风向 |
| power | string | 风力 |
| aqi | string | 空气质量指数 |
| future | object | 近5天天气情况 |
| date | string | 日期 |
| temperature | string | 温度，最低温/最高温 |
| weather | string | 天气情况 |
| direct | string | 风向 |
JSON返回示例:
{
"code": 1,
"msg": "操作成功",
"data": {
"city": "北京",
"realtime": {
"temperature": "15",
"humidity": "7",
"info": "晴",
"wid": "00",
"direct": "北风",
"power": "2级",
"aqi": "28"
},
"future": [
{
"date": "2022-03-27",
"temperature": "6/15℃",
"weather": "晴",
"wid": {
"day": "00",
"night": "00"
},
"direct": "西南风"
},
{
"date": "2022-03-28",
"temperature": "8/18℃",
"weather": "多云",
"wid": {
"day": "01",
"night": "01"
},
"direct": "南风"
},
{
"date": "2022-03-29",
"temperature": "5/11℃",
"weather": "小雨",
"wid": {
"day": "07",
"night": "07"
},
"direct": "东风转东北风"
},
{
"date": "2022-03-30",
"temperature": "3/14℃",
"weather": "多云转晴",
"wid": {
"day": "01",
"night": "00"
},
"direct": "东北风转西风"
},
{
"date": "2022-03-31",
"temperature": "2/16℃",
"weather": "晴",
"wid": {
"day": "00",
"night": "00"
},
"direct": "西北风转东北风"
}
]
}
}
接口地址：http://api.tanshuapi.com/api/weather/v1/life
返回格式：json
请求方式：不限
请求示例：http://api.tanshuapi.com/api/weather/v1/life?key=&city=1
接口备注：通过城市名称或城市ID查询城市生活指数，如：运动指数、紫外线指数、穿衣指数等等。有些指数，有时可能为空。
请求参数说明:
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| key | 是 | string | 个人中心查看 |
| city | 是 | string | 查询的城市名称或者城市id |
返回参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| city | string | 城市名称 |
| list | object | 见JSON返回示例 |
JSON返回示例:
{
"code": 1,
"msg": "操作成功",
"data": {
"city": "北京",
"list": {
"kongtiao": {/*空调开启*/
"v": "开启制暖空调",/*指数*/
"des": "您将感到有些冷，可以适当开启制暖空调调节室内温度，以免着凉感冒。"/*指数详情*/
},
"guomin": {/*过敏*/
"v": "极不易发",
"des": "天气条件极不易诱发过敏，可放心外出，享受生活。"
},
"shushidu": {/*舒适度*/
"v": "较不舒适",
"des": "白天天气晴好，但仍会使您感觉偏冷，不很舒适，请注意适时添加衣物，以防感冒。"
},
"chuanyi": {/*穿衣*/
"v": "冷",
"des": "天气冷，建议着棉服、羽绒服、皮夹克加羊毛衫等冬季服装。年老体弱者宜着厚棉衣、冬大衣或厚羽绒服。"
},
"diaoyu": {/*钓鱼*/
"v": "不宜",
"des": "天气冷，不适合垂钓。"
},
"ganmao": {/*感冒*/
"v": "较易发",
"des": "昼夜温差较大，较易发生感冒，请适当增减衣服。体质较弱的朋友请注意防护。"
},
"ziwaixian": {/*紫外线*/
"v": "弱",
"des": "紫外线强度较弱，建议出门前涂擦SPF在12-15之间、PA+的防晒护肤品。"
},
"xiche": {/*洗车*/
"v": "较适宜",
"des": "较适宜洗车，未来一天无雨，风力较小，擦洗一新的汽车至少能保持一天。"
},
"yundong": {/*运动*/
"v": "较不宜",
"des": "天气较好，但考虑天气寒冷，推荐您进行室内运动，户外运动时请注意保暖并做好准备活动。"
},
"daisan": {/*带伞*/
"v": "不带伞",
"des": "天气较好，您在出门的时候无须带雨伞。"
}
}
}
}
接口地址：http://api.tanshuapi.com/api/weather/v1/wids
返回格式：json
请求方式：不限
请求示例：http://api.tanshuapi.com/api/weather/v1/wids?key=
接口备注：查询天气种类列表（可以程序内置，无需每次读取）
请求参数说明:
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| key | 是 | string | 个人中心查看 |
返回参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| list | object | 列表 |
| wid | string | 天气标识ID |
| weather | string | 天气名称 |
JSON返回示例:
{
"code": 1,
"msg": "操作成功",
"data": [
{
"wid": "00",
"weather": "晴"
},
{
"wid": "01",
"weather": "多云"
},
{
"wid": "02",
"weather": "阴"
},
{
"wid": "03",
"weather": "阵雨"
},
{
"wid": "04",
"weather": "雷阵雨"
},
{
"wid": "05",
"weather": "雷阵雨伴有冰雹"
},
{
"wid": "06",
"weather": "雨夹雪"
},
{
"wid": "07",
"weather": "小雨"
},
{
"wid": "08",
"weather": "中雨"
},
{
"wid": "09",
"weather": "大雨"
},
{
"wid": "10",
"weather": "暴雨"
},
{
"wid": "11",
"weather": "大暴雨"
},
{
"wid": "12",
"weather": "特大暴雨"
},
{
"wid": "13",
"weather": "阵雪"
},
{
"wid": "14",
"weather": "小雪"
},
{
"wid": "15",
"weather": "中雪"
},
{
"wid": "16",
"weather": "大雪"
},
{
"wid": "17",
"weather": "暴雪"
},
{
"wid": "18",
"weather": "雾"
},
{
"wid": "19",
"weather": "冻雨"
},
{
"wid": "20",
"weather": "沙尘暴"
},
{
"wid": "21",
"weather": "小到中雨"
},
{
"wid": "22",
"weather": "中到大雨"
},
{
"wid": "23",
"weather": "大到暴雨"
},
{
"wid": "24",
"weather": "暴雨到大暴雨"
},
{
"wid": "25",
"weather": "大暴雨到特大暴雨"
},
{
"wid": "26",
"weather": "小到中雪"
},
{
"wid": "27",
"weather": "中到大雪"
},
{
"wid": "28",
"weather": "大到暴雪"
},
{
"wid": "29",
"weather": "浮尘"
},
{
"wid": "30",
"weather": "扬沙"
},
{
"wid": "31",
"weather": "强沙尘暴"
},
{
"wid": "53",
"weather": "霾"
}
]
}
接口地址：http://api.tanshuapi.com/api/weather/v1/citylist
返回格式：json
请求方式：不限
请求示例：http://api.tanshuapi.com/api/weather/v1/citylist?key=
接口备注：查询当前支持的城市列表及城市ID（可以一次性读取保存）;
请求参数说明:
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| key | 是 | string | 个人中心查看 |
返回参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| list | object | 列表 |
| id | string | 城市ID |
| province | string | 省份 |
| city | string | 城市 |
| district | string | 地区 |
JSON返回示例:
{
"code": 1,
"msg": "操作成功",
"data": {
"list": [
{
"id": "1",
"province": "北京",
"city": "北京",
"district": "北京"
},
{
"id": "2",
"province": "北京",
"city": "北京",
"district": "海淀"
},
{
"id": "3",
"province": "北京",
"city": "北京",
"district": "朝阳"
},
{
"id": "4",
"province": "北京",
"city": "北京",
"district": "顺义"
},
{
"id": "5",
"province": "北京",
"city": "北京",
"district": "怀柔"
},
{
"id": "6",
"province": "北京",
"city": "北京",
"district": "通州"
},
{
"id": "7",
"province": "北京",
"city": "北京",
"district": "昌平"
},
{
"id": "8",
"province": "北京",
"city": "北京",
"district": "延庆"
},
{
"id": "9",
"province": "北京",
"city": "北京",
"district": "丰台"
},
{
"id": "10",
"province": "北京",
"city": "北京",
"district": "石景山"
},
{
"id": "11",
"province": "北京",
"city": "北京",
"district": "大兴"
},
{
"id": "12",
"province": "北京",
"city": "北京",
"district": "房山"
},
{
"id": "13",
"province": "北京",
"city": "北京",
"district": "密云"
},
{
"id": "14",
"province": "北京",
"city": "北京",
"district": "门头沟"
},
{
"id": "15",
"province": "北京",
"city": "北京",
"district": "平谷"
},
{
"id": "16",
"province": "上海",
"city": "上海",
"district": "上海"
},
{
"id": "17",
"province": "上海",
"city": "上海",
"district": "闵行"
},
{
"id": "18",
"province": "上海",
"city": "上海",
"district": "宝山"
},
{
"id": "19",
"province": "上海",
"city": "上海",
"district": "嘉定"
},
{
"id": "21",
"province": "上海",
"city": "上海",
"district": "金山"
},
{
"id": "22",
"province": "上海",
"city": "上海",
"district": "青浦"
},
{
"id": "23",
"province": "上海",
"city": "上海",
"district": "松江"
},
{
"id": "24",
"province": "上海",
"city": "上海",
"district": "奉贤"
},
{
"id": "25",
"province": "上海",
"city": "上海",
"district": "崇明"
},
{
"id": "28",
"province": "天津",
"city": "天津",
"district": "天津"
},
{
"id": "29",
"province": "天津",
"city": "天津",
"district": "武清"
},
{
"id": "30",
"province": "天津",
"city": "天津",
"district": "宝坻"
},
{
"id": "31",
"province": "天津",
"city": "天津",
"district": "东丽"
},
{
"id": "32",
"province": "天津",
"city": "天津",
"district": "西青"
},
{
"id": "33",
"province": "天津",
"city": "天津",
"district": "北辰"
},
{
"id": "34",
"province": "天津",
"city": "天津",
"district": "宁河"
},
{
"id": "36",
"province": "天津",
"city": "天津",
"district": "静海"
},
{
"id": "37",
"province": "天津",
"city": "天津",
"district": "津南"
},
{
"id": "40",
"province": "天津",
"city": "天津",
"district": "蓟县"
},
{
"id": "41",
"province": "重庆",
"city": "重庆",
"district": "重庆"
},
{
"id": "42",
"province": "重庆",
"city": "重庆",
"district": "永川"
},
{
"id": "43",
"province": "重庆",
"city": "重庆",
"district": "合川"
},
{
"id": "44",
"province": "重庆",
"city": "重庆",
"district": "南川"
},
{
"id": "45",
"province": "重庆",
"city": "重庆",
"district": "江津"
},
{
"id": "46",
"province": "重庆",
"city": "重庆",
"district": "万盛"
},
{
"id": "47",
"province": "重庆",
"city": "重庆",
"district": "渝北"
},
{
"id": "48",
"province": "重庆",
"city": "重庆",
"district": "北碚"
},
{
"id": "49",
"province": "重庆",
"city": "重庆",
"district": "巴南"
},
{
"id": "50",
"province": "重庆",
"city": "重庆",
"district": "长寿"
},
{
"id": "51",
"province": "重庆",
"city": "重庆",
"district": "黔江"
},
{
"id": "52",
"province": "重庆",
"city": "重庆",
"district": "万州"
},
{
"id": "53",
"province": "重庆",
"city": "重庆",
"district": "涪陵"
},
{
"id": "54",
"province": "重庆",
"city": "重庆",
"district": "开县"
},
{
"id": "55",
"province": "重庆",
"city": "重庆",
"district": "城口"
},
{
"id": "56",
"province": "重庆",
"city": "重庆",
"district": "云阳"
},
{
"id": "57",
"province": "重庆",
"city": "重庆",
"district": "巫溪"
},
{
"id": "58",
"province": "重庆",
"city": "重庆",
"district": "奉节"
},
{
"id": "59",
"province": "重庆",
"city": "重庆",
"district": "巫山"
},
{
"id": "60",
"province": "重庆",
"city": "重庆",
"district": "潼南"
},
{
"id": "61",
"province": "重庆",
"city": "重庆",
"district": "垫江"
},
{
"id": "62",
"province": "重庆",
"city": "重庆",
"district": "梁平"
},
{
"id": "63",
"province": "重庆",
"city": "重庆",
"district": "忠县"
},
{
"id": "64",
"province": "重庆",
"city": "重庆",
"district": "石柱"
},
{
"id": "65",
"province": "重庆",
"city": "重庆",
"district": "大足"
},
{
"id": "66",
"province": "重庆",
"city": "重庆",
"district": "荣昌"
},
{
"id": "67",
"province": "重庆",
"city": "重庆",
"district": "铜梁"
},
{
"id": "68",
"province": "重庆",
"city": "重庆",
"district": "璧山"
},
{
"id": "69",
"province": "重庆",
"city": "重庆",
"district": "丰都"
},
{
"id": "70",
"province": "重庆",
"city": "重庆",
"district": "武隆"
},
{
"id": "71",
"province": "重庆",
"city": "重庆",
"district": "彭水"
},
{
"id": "72",
"province": "重庆",
"city": "重庆",
"district": "綦江"
},
{
"id": "73",
"province": "重庆",
"city": "重庆",
"district": "酉阳"
},
{
"id": "74",
"province": "重庆",
"city": "重庆",
"district": "秀山"
}
]
}
}
服务级错误码参照:
| 错误码 | 说明 |
|---|---|
| 208701 | 缺少必要参数 |
| 208702 | 错误的查询城市名 |
| 208703 | 查询失败 |
系统级错误码参照:
| 错误码 | 说明 |
|---|---|
| 10001 | 错误的请求KEY |
| 10002 | 该KEY无请求权限 |
| 10003 | KEY过期 |
| 10004 | 未知的请求源 |
| 10005 | 被禁止的IP |
| 10006 | 被禁止的KEY |
| 10007 | 请求超过次数限制 |
| 10008 | 接口维护 |
请求链接
- 请求结果
- 请求Header
产品说明
● 根据城市查询天气：输入城市可查询未来5天的天气情况，如：温度、湿度、风向等信息。
● 通过城市名称或城市ID查询城市生活指数，如：运动指数、紫外线指数、穿衣指数等等。有些指数，有时可能为空。
● 提供优质的技术服务，专人答疑、专人对接及定制需求。
应用场景
● 媒体和新闻：新闻网站、移动端，提供给用户持续更新的天气信息。
● 科研和教育：气象研究机构运用预报数据进行气候模式研究。
使用流程
平台注册
注册平台新账号，并实名认证
免费试用
申请需要的API，获得免费次数
在线测试
根据文档进行调试，是否满足业务需求
购买使用
购买后，集成发布到您的应用
服务介绍
稳定安全
保障您的业务运作无忧。
多样灵活
提供多元化的接口选项。
业务合规
数据合规，高标准。
售后可靠
专业服务，有效解答。
