天气预报查询

查询天气情况：温度、湿度、AQI、天气、风向等。

600次/月普通会员

30000次/月白银会员

1000000次/月钻石会员

不限调用量钻石会员PLUS

立即申请

免费测试

产品介绍

API文档

错误码参照

调试工具

接口地址：https://api.tanshuapi.com/api/weather/v1/index

返回格式：json

请求方式：不限

请求示例：https://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": "西北风转东北风"
            }
        ]
    }
}

接口地址：https://api.tanshuapi.com/api/weather/v1/life

返回格式：json

请求方式：不限

请求示例：https://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": "天气较好，您在出门的时候无须带雨伞。"
            }
        }
    }
}

接口地址：https://api.tanshuapi.com/api/weather/v1/wids

返回格式：json

请求方式：不限

请求示例：https://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": "霾"
        }
    ]
}

接口地址：https://api.tanshuapi.com/api/weather/v1/citylist

返回格式：json

请求方式：不限

请求示例：https://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	接口维护