天气查询v4

# 天气查询API v4 文档 ## 接口地址 `https://api.xunjinlu.fun/api/weather/v4.php` ## 接口说明 本接口提供专业的天气查询服务，支持实时天气和7天天气预报查询。数据准确可靠，返回格式化的JSON数据，方便开发者快速集成。(数据来源全国气象站) ## 请求方式 - **支持方法：** GET / POST - **编码格式：** UTF-8 - **返回格式：** JSON ## 请求参数 ### 表格版 | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | -- | ----------------------------------------------- | | city | string | 否 | 城市名称，支持模糊匹配。例如：北京、上海、曲靖市陆良县等 | | id | string | 否 | 气象站编码，例如：54511（北京）、56788（曲靖陆良）。与city参数二选一，优先使用id | | type | string | 否 | 查询类型：`now`（实时天气，默认）、`7day` 或 `7`（7天天气预报） | ## 响应参数说明 ### 实时天气响应字段 | 字段路径 | 类型 | 说明 | |----------|------|------| | code | int | 状态码，200表示成功 | | message | string | 响应消息 | | data.location.id | string | 气象站编码 | | data.location.name | string | 地区名称 | | data.location.path | string | 地区完整路径 | | data.current.temperature.current | float | 当前温度（摄氏度） | | data.current.temperature.feels_like | float | 体感温度（摄氏度） | | data.current.humidity | float | 湿度（百分比） | | data.current.pressure | float | 气压 | | data.current.precipitation | float | 降水量 | | data.current.wind.direction | string | 风向 | | data.current.wind.direction_degree | float | 风向角度 | | data.current.wind.speed | float | 风速 | | data.current.wind.scale | string | 风力等级 | | data.alerts | array | 预警信息数组 | | data.update_time | string | 数据更新时间 | | api_info | object | API开发者信息 | ### 7天天气预报响应字段 | 字段路径 | 类型 | 说明 | |----------|------|------| | data.forecast | array | 7天预报数组 | | data.forecast[].date | string | 日期 | | data.forecast[].temperature.high | float | 最高温度（摄氏度） | | data.forecast[].temperature.low | float | 最低温度（摄氏度） | | data.forecast[].condition.day.text | string | 白天天气现象 | | data.forecast[].condition.day.code | int | 白天天气代码 | | data.forecast[].condition.night.text | string | 夜间天气现象 | | data.forecast[].condition.night.code | int | 夜间天气代码 | | data.forecast[].wind.day.direction | string | 白天风向 | | data.forecast[].wind.day.scale | string | 白天风力等级 | | data.forecast[].wind.night.direction | string | 夜间风向 | | data.forecast[].wind.night.scale | string | 夜间风力等级 | ## 请求示例 ### 示例1：查询北京实时天气 ``` ``` ### 示例2：通过气象站编码查询实时天气 ``` ``` ### 示例3：查询7天天气预报 ``` ``` ### 示例4：查询县级市天气 ``` ```` ## 响应示例 ### 实时天气响应示例 **请求URL：** `https://api.xunjinlu.fun/api/weather/v4.php?city=北京` **响应数据：** ```json { "code": 200, "message": "success", "data": { "location": { "id": "54511", "name": "北京", "path": "中国, 北京, 北京" }, "current": { "temperature": { "current": 16.9, "feels_like": 12.9 }, "humidity": 25.0, "pressure": 1000.0, "precipitation": 0.0, "wind": { "direction": "西南风", "direction_degree": 219.0, "speed": 5.3, "scale": "3级" } }, "alerts": [ { "id": "11000041600000_20260403202724", "title": "北京市气象台2026年04月03日20时20分降级发布大风蓝色预警信号", "type": "大风", "level": "蓝色", "effective": "2026/04/03 20:20" } ], "update_time": "2026/04/04 14:00" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ```` ### 7天天气预报响应示例 **请求URL：** `https://api.xunjinlu.fun/api/weather/v4.php?city=北京&type=7day` **响应数据：** ```json { "code": 200, "message": "success", "data": { "location": { "id": "54511", "name": "北京", "path": "中国, 北京, 北京" }, "forecast": [ { "date": "2026/04/04", "temperature": { "high": 19.0, "low": 8.0 }, "condition": { "day": { "text": "晴", "code": 0 }, "night": { "text": "多云", "code": 1 } }, "wind": { "day": { "direction": "南风", "scale": "3~4级" }, "night": { "direction": "西北风", "scale": "微风" } } }, { "date": "2026/04/05", "temperature": { "high": 19.0, "low": 5.0 }, "condition": { "day": { "text": "晴", "code": 0 }, "night": { "text": "多云", "code": 1 } }, "wind": { "day": { "direction": "西北风", "scale": "3~4级" }, "night": { "direction": "北风", "scale": "微风" } } } ], "update_time": "2026/04/04 12:00" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ### 错误响应示例 ```json { "code": 400, "message": "请提供城市名称或气象站编码(id)参数", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ## 状态码说明 | 状态码 | 说明 | | --- | --------- | | 200 | 请求成功 | | 400 | 请求参数错误 | | 500 | 服务器内部错误 | | 503 | 天气服务暂时不可用 | ## 注意事项 1. `city` 和 `id` 参数至少提供一个，同时提供时优先使用 `id` 2. 城市名称支持模糊匹配，建议使用完整的地区名称以获得更准确的结果 3. 返回的JSON数据已格式化，可直接使用，无需额外解码 4. 所有响应数据均包含 `api_info` 字段，包含开发者信息 5. 数据更新频率：实时天气约每小时更新一次，天气预报每天更新 ## 技术支持 - **开发者博客：** - **API平台：**