首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >天气预报-IP查询版免费API接口使用指南

天气预报-IP查询版免费API接口使用指南

原创
作者头像
用户9840656
发布2025-07-01 09:38:25
发布2025-07-01 09:38:25
1.6K0
举报
接口简介

根据IP地址自动获取所在地的实时天气信息。数据来源权威可靠,支持自动识别调用者IP或指定查询任意IP地址的天气。


接口特性
  1. 智能IP识别
    • 支持自动获取调用接口的IP地址
    • 可选指定任意IP查询(如ip=49.234.56.78
    • 查询失败时默认返回北京天气
  2. 数据权威​ 数据直接来源于中国气象局官方,包含:
    • 温度、湿度、气压、降水量
    • 风向/风速详情
    • 双天气状态(如"晴转多云"拆分为weather1weather2
  3. 免费使用
    • 无每日调用次数限制
    • 需注册获取个人ID和KEY(共享KEY有频次限制)

请求参数

参数

必填

说明

示例

id

用户中心数字ID

id=10000000

key

用户中心通讯秘钥

key=15he5h15ty854j5

ip

要查询的IP(不传则自动获取)

ip=49.234.56.78


返回参数
代码语言:javascript
复制
jsonjson复制json复制{
  "code": 200,                   // 状态码(200成功/400错误)
  "msg": "",                     // 错误提示信息(code=400时出现)
  "precipitation": 0,            // 降水量(mm)
  "temperature": 32.9,           // 温度(℃)
  "pressure": 1010,              // 气压(hPa)
  "humidity": 53,                // 湿度(%)
  "windDirection": "东北风",      // 风向
  "windDirectionDegree": 17,     // 风向角度(0~360)
  "windSpeed": 1.2,              // 风速(m/s)
  "windScale": "微风",           // 风速描述
  "place": "中国, 上海, 徐家汇",  // 地理位置
  "ip": "49.234.56.78",          // 返回的IP地址
  "weather1": "多云",            // 主天气状态
  "weather2": "晴"               // 次天气状态
}

调用示例(Python)
代码语言:javascript
复制
pythonpython运行复制python运行复制import requests

# 用户注册后获取的凭证(需替换为自己的ID和KEY)
USER_ID = "your_id"
API_KEY = "your_key"
TARGET_IP = "49.234.56.78"  # 可选:不传则自动识别调用者IP

url = "https://cn.apihz.cn/api/tianqi/tqybip.php"
params = {
    "id": USER_ID,
    "key": API_KEY,
    "ip": TARGET_IP  # 删除此行则自动获取IP
}

response = requests.get(url, params=params)
weather_data = response.json()

if weather_data["code"] == 200:
    print(f"地点: {weather_data['place']}")
    print(f"天气: {weather_data['weather1']}转{weather_data['weather2']}")
    print(f"温度: {weather_data['temperature']}℃ 湿度: {weather_data['humidity']}%")
    print(f"风速: {weather_data['windScale']}({weather_data['windSpeed']}m/s)")
else:
    print(f"请求失败: {weather_data['msg']}")

注意事项
  1. 账号申请​ 访问接口盒子官网注册获取个人ID和KEY,避免使用示例中的公共凭证(id=88888888&key=88888888),公共KEY有每分钟调用频次限制。
  2. 错误处理
    • code=400时检查msg字段(常见错误:秘钥错误/IP格式无效)
    • 网络异常时重试机制建议
  3. 数据更新 天气数据每30分钟更新一次,频繁调用请缓存数据。

版权声明:数据来源于中国气象局,官方文档详见apihz.cn参考资料


通过此API可快速集成权威天气数据到各类应用中,适合网站/IP定位服务/智能设备等场景使用。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 接口简介
  • 接口特性
  • 请求参数
  • 返回参数
  • 调用示例(Python)
  • 注意事项
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档