极速数据全国天气预报API接口使用指南

发布时间：2025-03-28 15:28 点击：4067次

一、概述

全国天气预报API提供全国3000多个省市的天气预报查询，包括实时天气气温、最高最低温度、风级、风力、湿度、气压，穿衣、运动、洗车、感冒、空气污染扩散、紫外线等指数，7天天气、风力、最低最高温度、日出日落时间，未来24小时的时天气、气温，空气质量指数、PM2.5指数等信息，支持城市ID、城市名称、城市代码、IP地址、经纬度等多种方式查询，20分钟更新一次。

二、注册和申请数据

        1、注册账号地址：https://www.jisuapi.com/my/reg
        2、实名认证
        3、申请数据地址：https://www.jisuapi.com/api/weather
        4、获取APPKEY 在会员中心，右上角
        5、接口调试

三、请求参数

参数名	类型	必填	说明
appkey	string	是
city	string	否	城市名（如“杭州”），需UTF-8编码
cityid	int	否	城市ID
citycode	string	否	城市天气代号（如“101260301”）
location	string	否	经纬度，格式为“纬度,经度”（如“39.983424,116.322987”）
ip	string	否	查询IP所在城市天气

注意：city、cityid、citycode、location、ip参数四选一，不传则默认返回当前IP城市天气。

四、返回字段说明

1、城市、天气的基本信息，如：天气、温度、湿度、风速。
2、生活指数，如：穿衣指数、运动指数、紫外线指数、洗车指数等。
3、空气质量指数：包括AQI、PM2.5、PM10指数、首要污染物等
4、未来7天预报，包括日期、日出日落时间、白天天气、风速、风向、温度、夜间天气、风速、风向、温度。
5、未来24小时天气，包括时间、天气、温度。

五、Python示例代码

import requests

# 配置参数
params = {
    "appkey": "your_appkey_here",  # 替换为实际appkey
    "city": "杭州"
}

# 发送请求
url = "https://api.jisuapi.com/weather/query"
response = requests.get(url, params=params)
data = response.json()

# 错误处理
if data["status"] != 0:
    print(f"请求失败：{data['msg']}")
    exit()

result = data["result"]

# 解析实时天气
print(f"城市：{result['city']} 日期：{result['date']} 天气：{result['weather']}")
print(f"温度：{result['temp']}℃ 最高温：{result['temphigh']}℃ 最低温：{result['templow']}℃")

# 解析7天预报
print("\n未来7天预报：")
for day in result["daily"]:
    print(f"{day['date']} {day['week']}: 白天{day['day']['weather']} {day['day']['temphigh']}℃, 夜间{day['night']['weather']} {day['night']['templow']}℃")

# 解析空气质量
aqi = result["aqi"]
print(f"\n空气质量：{aqi['quality']} AQI：{aqi['aqi']} 首要污染物：{aqi['primarypollutant']}")

天气数字ID图标展示地址：https://www.jisuapi.com/demo/weather/icon，下载地址：http://api.jisuapi.com/weather/icon.zip
极速数据天气预报API，覆盖面广，更新及时，服务稳定，返回数据完备。支持各种方式查询，返回标准的JSON格式，提供多种语言示例，方便开发者快速接入天气服务。同时天气的价格只有48元/100000次，性价比高。极速数据同时提供快速、周到的技术服务，为您的开发工作保驾护航。