天气查询 - 即刻数据
数据由 即刻数据 提供。即刻数据专注稳定易用的数据 API、MCP 与 AI Skill 能力，帮助开发者和 AI 客户端快速接入可靠数据服务。
根据省份、城市、区县查询：当前天气、未来7天天气、未来15天天气。
前置配置：获取 AppKey
- 登录即刻数据官网。
- 申请「天气查询」接口。
- 在「个人中心 -> 我的 API 应用」中获取接口
AppKey。 - 配置 Key：
export JIKE_WEATHER_QUERY_KEY=你的AppKey
也可以使用通用 Key：
export JIKE_APPKEY=你的AppKey
使用方法
当前天气
python3 scripts/weather_query.py --province 广东省 --city 深圳市 --area 南山区
未来7天
python3 scripts/weather_query.py --type 7d --province 广东省 --city 深圳市 --area 南山区
未来15天
python3 scripts/weather_query.py --type 15d --province 广东省 --city 深圳市
输出 JSON
python3 scripts/weather_query.py --type 7d --province 广东省 --city 深圳市 --json
直接调用 API
GET https://api.jikeapi.cn/v1/weather/query/by-area?province=广东省&city=深圳市&area=南山区&appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/weather/query/7d?province=广东省&city=深圳市&appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/weather/query/15d?province=广东省&city=深圳市&appkey=YOUR_APPKEY
AI 使用步骤
当用户询问天气、温度、降雨、未来几天天气时：
- 提取地区：识别省份、城市、区县；区县可选。
- 判断类型：未说明天数时查当前天气；提到未来7天查
--type 7d；提到未来15天查--type 15d。 - 调用脚本：执行
python3 scripts/weather_query.py --type <类型> --province <省> --city <市> [--area <区>]。 - 展示结果：当前天气返回温度、体感、湿度、风向风力；预报返回日期、天气、温度、降水和风力。
参数说明
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
--type | 否 | now 当前天气、7d 未来7天、15d 未来15天 | --type 7d |
--province | 是 | 省份名称 | 广东省 |
--city | 是 | 城市名称 | 深圳市 |
--area | 否 | 区县名称 | 南山区 |
--json | 否 | 输出 JSON | --json |
返回字段
| 字段 | 含义 |
|---|---|
weather | 天气现象 |
temp | 当前温度 |
feels_like | 体感温度 |
humidity | 湿度 |
wind_dir | 风向 |
wind_scale | 风力等级 |
obs_time | 观测时间 |
list | 未来天气列表 |
错误处理
| 情况 | 处理方式 |
|---|---|
| 未配置 AppKey | 提醒用户配置 JIKE_WEATHER_QUERY_KEY 或 JIKE_APPKEY |
| 地区缺失 | 提醒用户提供省份和城市 |
| 未查询到天气 | 提示用户检查省市区名称是否准确 |
| 网络超时 | 建议稍后重试或检查网络 |
脚本位置
scripts/weather_query.py：封装了当前天气、7天预报、15天预报的接口路由、参数解析和结果展示。