查询 城市 县区的天气情况
接口地址: http://api.xcvts.cn/api/weather
返回格式: JSON
请求方式: GET
请求示例: http://api.xcvts.cn/api/weather?city=深圳 调用测试
请求参数说明:
名称 | 是否必填 | 类型 | 说明 | 接口测试 |
---|---|---|---|---|
city | 上 | String | 需要查询的地区名称,例如:上海,深圳,成都 | 调用测试 |
type | 否 | String | 返回格式,默认json(text/json) | 调用测试 |
返回参数说明:
名称 | 类型 | 说明 |
---|
返回示例:
{ "code": 1, "text": "获取成功", "data": { "city": "深圳", "cityEnglish": "shenzhen", "temp": "999", "tempn": "30", "weather": "阴转阵雨", "wind": "西南风转微风", "windSpeed": "3-4级转<3级", "time": "2025-07-10 08:00", "warning": { "windSpeed": "09", "wind": "雷电", "color": "黄色", "warning": "【深圳市雷电黄色预警信号】深圳市气象台于2025年07月09日18时01分发布全市雷电黄色预警信号,预计2小时内全市将受雷电影响。市民停留在安全地方。(预警信息来源:国家预警信息发布中心)", "time": "2025-07-10 18:02:00" }, "current": { "city": "深圳", "cityEnglish": "shenzhen", "humidity": "94%", "wind": "南风", "windSpeed": "1级", "visibility": "11km", "weather": "小雨", "weatherEnglish": "Light rain", "temp": "25.1", "fahrenheit": "77.2", "air": "27", "air_pm25": "27", "date": "07月10日(星期四)", "time": "02:00", "image": "http://api.xcvts.cn/zaixian/weather/image/%E5%B0%8F%E9%9B%A8.png" }, "living": [ { "name": "穿衣指数", "index": "热", "tips": "适合穿T恤、短薄外套等夏季服装。" }, { "name": "路况指数", "index": "潮湿", "tips": "有降水,路面潮湿,请小心驾驶。" }, { "name": "钓鱼指数", "index": "较适宜", "tips": "天气稍热会对垂钓产生一定影响。" }, { "name": "晨练指数", "index": "不宜", "tips": "有降水,请尽量避免户外晨练。" }, { "name": "夜生活指数", "index": "较适宜", "tips": "只要您稍作准备就可以放心外出。" }, { "name": "紫外线强度指数", "index": "最弱", "tips": "辐射弱,涂擦SPF8-12防晒护肤品。" }, { "name": "感冒指数", "index": "少发", "tips": "感冒机率较低,避免长期处于空调屋中。" }, { "name": "逛街指数", "index": "较不宜", "tips": "有降水,较不适宜逛街" }, { "name": "空气污染扩散条件指数", "index": "良", "tips": "气象条件有利于空气污染物扩散。" }, { "name": "旅游指数", "index": "适宜", "tips": "有降水,稍热,出游请注意携带雨具。" }, { "name": "舒适度指数", "index": "较不舒适", "tips": "白天有雨,气温较高,闷热。" }, { "name": "啤酒指数", "index": "适宜", "tips": "天热潮湿,适宜饮用冰镇啤酒,不要贪杯。" }, { "name": "划船指数", "index": "不适宜", "tips": "天气不好,建议选择别的娱乐方式。" }, { "name": "太阳镜指数", "index": "不需要", "tips": "白天能见度差不需要佩戴太阳镜" }, { "name": "风寒指数", "index": "无", "tips": "温度未达到风寒所需的低温,稍作防寒准备即可。" }, { "name": "放风筝指数", "index": "不宜", "tips": "天气不好,不适宜放风筝。" }, { "name": "空调开启指数", "index": "部分时间开启", "tips": "午后天气炎热可适时开启制冷空调。" }, { "name": "晾晒指数", "index": "不太适宜", "tips": "降水可能会淋湿衣物,不适宜晾晒。" }, { "name": "洗车指数", "index": "不宜", "tips": "有雨,雨水和泥水会弄脏爱车。" }, { "name": "心情指数", "index": "较差", "tips": "雨水带来一丝清凉,让烦躁的心绪降温。" }, { "name": "中暑指数", "index": "易发", "tips": "天气炎热,着装最好选择吸汗能力强、通气性好、穿着舒服的衣服。" }, { "name": "交通指数", "index": "一般", "tips": "有降水且路面湿滑,注意保持车距。" }, { "name": "约会指数", "index": "较不适宜", "tips": "建议尽量不要去室外约会。" }, { "name": "运动指数", "index": "较不宜", "tips": "有降水,推荐您在室内进行休闲运动。" }, { "name": "过敏指数", "index": "不易发", "tips": "除特殊体质,无需担心过敏问题。" }, { "name": "美发指数", "index": "一般", "tips": "天热,头皮皮脂分泌多,注意清洁。" }, { "name": "雨伞指数", "index": "带伞", "tips": "有降水,短时间出行不必带伞。" }, { "name": "防晒指数", "index": "弱", "tips": "涂抹8-12SPF防晒护肤品。" }, { "name": "化妆指数", "index": "去油", "tips": "请选用露质面霜打底,水质无油粉底霜。" }, { "name": "干燥指数", "index": "适宜", "tips": "温湿条件适宜,风速不大,皮肤无需特殊保养,只做日常护理即可。" } ] } }
请求参数设置:
参数名称 | 参数值 |
---|---|
{ "code": 1, "text": "获取成功", "data": { "city": "深圳", "cityEnglish": "shenzhen", "temp": "999", "tempn": "30", "weather": "阴转阵雨", "wind": "西南风转微风", "windSpeed": "3-4级转<3级", "time": "2025-07-10 08:00", "warning": { "windSpeed": "09", "wind": "雷电", "color": "黄色", "warning": "【深圳市雷电黄色预警信号】深圳市气象台于2025年07月09日18时01分发布全市雷电黄色预警信号,预计2小时内全市将受雷电影响。市民停留在安全地方。(预警信息来源:国家预警信息发布中心)", "time": "2025-07-10 18:02:00" }, "current": { "city": "深圳", "cityEnglish": "shenzhen", "humidity": "94%", "wind": "南风", "windSpeed": "1级", "visibility": "11km", "weather": "小雨", "weatherEnglish": "Light rain", "temp": "25.1", "fahrenheit": "77.2", "air": "27", "air_pm25": "27", "date": "07月10日(星期四)", "time": "02:00", "image": "http://api.xcvts.cn/zaixian/weather/image/%E5%B0%8F%E9%9B%A8.png" }, "living": [ { "name": "穿衣指数", "index": "热", "tips": "适合穿T恤、短薄外套等夏季服装。" }, { "name": "路况指数", "index": "潮湿", "tips": "有降水,路面潮湿,请小心驾驶。" }, { "name": "钓鱼指数", "index": "较适宜", "tips": "天气稍热会对垂钓产生一定影响。" }, { "name": "晨练指数", "index": "不宜", "tips": "有降水,请尽量避免户外晨练。" }, { "name": "夜生活指数", "index": "较适宜", "tips": "只要您稍作准备就可以放心外出。" }, { "name": "紫外线强度指数", "index": "最弱", "tips": "辐射弱,涂擦SPF8-12防晒护肤品。" }, { "name": "感冒指数", "index": "少发", "tips": "感冒机率较低,避免长期处于空调屋中。" }, { "name": "逛街指数", "index": "较不宜", "tips": "有降水,较不适宜逛街" }, { "name": "空气污染扩散条件指数", "index": "良", "tips": "气象条件有利于空气污染物扩散。" }, { "name": "旅游指数", "index": "适宜", "tips": "有降水,稍热,出游请注意携带雨具。" }, { "name": "舒适度指数", "index": "较不舒适", "tips": "白天有雨,气温较高,闷热。" }, { "name": "啤酒指数", "index": "适宜", "tips": "天热潮湿,适宜饮用冰镇啤酒,不要贪杯。" }, { "name": "划船指数", "index": "不适宜", "tips": "天气不好,建议选择别的娱乐方式。" }, { "name": "太阳镜指数", "index": "不需要", "tips": "白天能见度差不需要佩戴太阳镜" }, { "name": "风寒指数", "index": "无", "tips": "温度未达到风寒所需的低温,稍作防寒准备即可。" }, { "name": "放风筝指数", "index": "不宜", "tips": "天气不好,不适宜放风筝。" }, { "name": "空调开启指数", "index": "部分时间开启", "tips": "午后天气炎热可适时开启制冷空调。" }, { "name": "晾晒指数", "index": "不太适宜", "tips": "降水可能会淋湿衣物,不适宜晾晒。" }, { "name": "洗车指数", "index": "不宜", "tips": "有雨,雨水和泥水会弄脏爱车。" }, { "name": "心情指数", "index": "较差", "tips": "雨水带来一丝清凉,让烦躁的心绪降温。" }, { "name": "中暑指数", "index": "易发", "tips": "天气炎热,着装最好选择吸汗能力强、通气性好、穿着舒服的衣服。" }, { "name": "交通指数", "index": "一般", "tips": "有降水且路面湿滑,注意保持车距。" }, { "name": "约会指数", "index": "较不适宜", "tips": "建议尽量不要去室外约会。" }, { "name": "运动指数", "index": "较不宜", "tips": "有降水,推荐您在室内进行休闲运动。" }, { "name": "过敏指数", "index": "不易发", "tips": "除特殊体质,无需担心过敏问题。" }, { "name": "美发指数", "index": "一般", "tips": "天热,头皮皮脂分泌多,注意清洁。" }, { "name": "雨伞指数", "index": "带伞", "tips": "有降水,短时间出行不必带伞。" }, { "name": "防晒指数", "index": "弱", "tips": "涂抹8-12SPF防晒护肤品。" }, { "name": "化妆指数", "index": "去油", "tips": "请选用露质面霜打底,水质无油粉底霜。" }, { "name": "干燥指数", "index": "适宜", "tips": "温湿条件适宜,风速不大,皮肤无需特殊保养,只做日常护理即可。" } ] } }
错误码格式说明:
名称 | 类型 | 说明 |
---|
代码示例: