开发指南

免费实况天气接口


包含基本天气、温度、风力风向、空气质量、气压、湿度等,可按地名、城市编号、IP查询。
支持最多30个城市ID同时查询。

收费方案

地区权限 请求限制 使用方案 发票
全国所有市区县 每日300次左右 个人免费使用3个月
全国所有市区县 每日2万次 100/一年 350/五年 600/永久 可开普票/电子票
全国所有市区县 每日5万次 200/一年 700/五年 1200/永久 可开普票/电子票
全国所有市区县 每日10万次 400/一年 1400/五年 2400/永久 可开普票/电子票
全国所有市区县 每日20万次 1000/一年 3500/五年 6000/永久 可开普票/电子票/专票
全国所有市区县 每日50万次 2500/一年 8750/五年 15000/永久 可开普票/电子票/专票
全国所有市区县 每日百万~千万次 联系客服开通独享版本,最低8800/年 可开普票/电子票/专票

请求方式及url:

  • 请求方式:GET

  • 线路1(推荐)http://v1.yiketianqi.com/free/day

请求示例

http://v1.yiketianqi.com/free/day?appid=&appsecret=&unescape=1

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
cityid string 城市ID 请参考 城市ID列表
如果您想查询多个城市(最多30个),请用英文逗号隔开, 如:cityid=101120101,101120201,101050101
city string 城市名称 不要带市和区, 支持市区县, 不支持乡镇级别; 如: 青岛、铁西
ip string IP地址 查询IP所在城市天气
callback string jsonp参数 如: jQuery.Callbacks
vue string 跨域参数 如果您使用的是react、vue、angular请填写值: 1
unescape Int 是否转义中文 如果您希望json不被unicode, 直接输出中文, 请传此参数: 1

备注

cityid、city和ip参数3选一提交,如果不传,默认返回当前ip城市天气,cityid优先级最高。

响应JSON

{
    "nums":226, //今日实时请求次数
    "cityid":"101120101", //城市ID
    "city":"济南",
    "date":"2022-05-05",
    "week":"星期四",
    "update_time":"22:38", //更新时间
    "wea":"多云", //天气情况
    "wea_img":"yun", //天气标识
    "tem":"25", //实况温度
    "tem_day":"30", //白天温度(高温)
    "tem_night":"23", //夜间温度(低温)
    "win":"南风", //风向
    "win_speed":"3级", //风力
    "win_meter":"19km\/h", //风速
    "air":"53", //空气质量
    "pressure":"987", //气压
    "humidity":"27%" //湿度
}

响应参数说明

参数名 类型 说明 备注
cityid String 城市ID
city String 城市名称
update_time String 更新时间
wea String 天气情况
wea_img String 天气对应图标 固定9种类型(您也可以根据wea字段自己处理):
xue、lei、shachen、wu、bingbao、yun、yu、yin、qing
tem String 实时温度
tem_day String 白天温度(高温)
tem_night String 白天温度(低温)
win String 风向
win_speed String 风力等级
win_meter String 风速
air String 空气质量