天气预报免费API接口【IP查询版】使用教程_天气预报接口

IP查询天气API为开发者提供了便捷的天气预报服务。该服务通过调用者IP自动定位地区，并返回精准的天气数据，数据来源权威可靠。本文将详细介绍该API的使用方法及调用示例。

一、API核心功能

• ​智能定位​：自动识别调用者IP地址所属地区
• ​灵活调用​：支持GET/POST两种请求方式
• ​精准返回​：提供温度、湿度、风向风速等15项气象数据

二、请求参数说明

​注意​：请前往接口盒子官网注册获取专属ID和KEY，避免使用示例中的公共密钥导致限流。

三、返回参数说明

返回JSON格式数据，主要字段包括：

• code：状态码（200成功/400错误）
• msg：错误提示信息
• temperature：当前温度（℃）
• humidity：湿度百分比
• windDirection：风向描述
• windSpeed：风速（m/s）
• place：地理位置信息
• weather1/weather2：组合天气状态

完整返回示例：

json

复制

{ \"precipitation\": 0, \"temperature\": 32.9, \"pressure\": 1010, \"humidity\": 53, \"windDirection\": \"东北风\", \"windDirectionDegree\": 17, \"windSpeed\": 1.2, \"windScale\": \"微风\", \"code\": 200, \"place\": \"中国, 上海, 徐家汇\", \"weather1\": \"多云\", \"weather2\": \"晴\", \"ip\": \"49.234.56.78\"}

四、调用示例代码

1. PHP调用示例

php

复制

2. Python调用示例

python

运行

复制

import requestsapi_url = \"https://cn.apihz.cn/api/tianqi/tqybip.php\"user_id = \"10000000\" # 替换为您的实际IDuser_key = \"15he5h15ty854j5sr152hs2\" # 替换为您的实际KEYtarget_ip = \"49.234.56.78\" # 可选参数# 构建请求参数params = { \"id\": user_id, \"key\": user_key, \"ip\": target_ip}# 发送GET请求response = requests.get(api_url, params=params)weather_data = response.json()if weather_data[\"code\"] == 200: print(f\"当前位置：{weather_data[\'place\']}\") print(f\"当前温度：{weather_data[\'temperature\']}℃\") print(f\"天气状况：{weather_data[\'weather1\']}转{weather_data[\'weather2\']}\")else: print(f\"请求失败：{weather_data[\'msg\']}\")

五、使用注意事项

1. ​密钥安全​：请妥善保管您的KEY，避免泄露
2. ​频率限制​：共享账号每分钟限流，建议使用自有账号
3. ​数据缓存​：建议本地缓存数据，避免频繁调用
4. ​错误处理​：务必检查code状态码后再处理数据
5. ​数据更新​：气象数据每30分钟更新一次

通过这个免费API，开发者可以轻松将精准天气预报功能集成到各类应用中，无论是网站、移动应用还是物联网设备，都能为用户提供实时可靠的天气信息服务。