开发指南

免费实况天气接口


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

请求方式及url:

  • 请求方式:GET

  • 线路1(推荐)https://v0.yiketianqi.com/free/day

  • 线路2:https://yiketianqi.com/free/day

请求示例

https://www.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 空气质量

收费方案

地区权限 请求限制 使用方案(报价为不开票价格) 发票
全国所有市区县 每日500次(不固定) 个人免费
全国所有市区县 每日2万次 100/一年(最低) 400/五年(最低) 780/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日5万次 200/一年(最低) 800/五年(最低) 1560/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日10万次 400/一年(最低) 1600/五年(最低) 3120/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日20万次 1000/一年(最低) 4000/五年(最低) 7800/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日50万次 2500/一年(最低) 10000/五年(最低) 19500/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日百万~千万次 联系客服开通独享版本,最低12800/年 可开普票/电子票/专票