开发指南

专业七日天气接口 收费在线测试此接口(需要登录)


更新时间:2020-01-20 10:44:09

行政中心5分钟更新一次, 县级市区25分钟更新一次,包含基本天气信息、湿度、每日小时预报、6大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等,可按地名、城市编号、IP查询。

请求方式及url:

  • 请求方式:GET

  • 接口地址:https://tianqiapi.com/api

请求示例

https://tianqiapi.com/api?version=v9&appid=&appsecret=

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
version string 接口版本标识 固定值: v9 每个接口的version值都不一样
cityid string 城市ID 请参考 城市ID列表
city string 城市名称 不要带市和区; 如: 青岛、铁西
ip string IP地址 查询IP所在城市天气
callback string jsonp参数 如: jQuery.Callbacks
vue string 跨域参数 如果您使用的是react、vue、angular请填写值: 1

备注

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

响应JSON

请点击 在线测试此接口(需要登录) 查看

响应参数说明

参数名 类型 说明 备注
cityid String 城市ID
update_time String 气象台更新时间
city String 城市名称
cityEn String 城市英文名称
country String 国家名称
countryEn String 国家英文名称
data String 每日数据列表 1-7日,共7组
 ┗ wea String 天气情况
 ┗ wea_img String 天气对应图标 固定9种类型(您也可以根据wea字段自己处理):
xue、lei、shachen、wu、bingbao、yun、yu、yin、qing
 ┗ tem String 实时温度
 ┗ tem1 String 高温
 ┗ tem2 String 低温
 ┗ win String 风向
 ┗ win_speed String 风力等级
 ┗ humidity String 湿度
 ┗ sunrise String 日出 例如:06:30
 ┗ sunset String 日出 例如:17:30
 ┗ visibility String 能见度
 ┗ pressure String 气压hPa
 ┗ air String 空气质量
 ┗ air_level String 空气质量等级
 ┗ air_tips String 空气质量描述
 ┗ alarm String 气象预警
      ┗ alarm_type String 预警类型
      ┗ alarm_level String 预警级别
      ┗ alarm_level String 预警详细信息
 ┗ hours String 小时预报
      ┗ hours String 时间点 例如:20时
      ┗ wea String 天气
      ┗ wea_img String 天气图标
      ┗ tem String 温度
      ┗ win String 风向
      ┗ win_speed String 风力等级
 ┗ index String 生活指数
      ┗ title String 指数类型 例如:穿衣指数
      ┗ level String 级别 例如:较冷
      ┗ desc String 描述 例如:建议着棉衣加羊毛衫等冬季服装。
 ┗ aqi String 空气质量指数
      ┗ air String 空气质量
      ┗ air_level String 空气质量等级
      ┗ air_tips String 空气质量提示
      ┗ pm25 String PM2.5
      ┗ pm25_desc String PM2.5等级描述
      ┗ pm10 String PM10
      ┗ pm10_desc String PM10等级描述
      ┗ o3 String o3
      ┗ o3_desc String o3等级描述
      ┗ no2 String no2
      ┗ no2_desc String no2等级描述
      ┗ so2 String so2
      ┗ so2_desc String so2等级描述
      ┗ kouzhao String 是否需要带口罩
      ┗ waichu String 外出适宜
      ┗ kaichuang String 开窗适宜
      ┗ jinghuaqi String 是否需要打开净化器