该接口最快3小时更新一次,包含基本天气信息、气象预警、湿度、能见度、气压、日出日落、每日小时预报、6大生活指数等,可按地名、城市编号、IP查询。
请求方式及url:
请求方式:GET
接口地址:https://tianqiapi.com/api
请求示例
https://tianqiapi.com/api?version=v1&appid=&appsecret=
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: v1 每个接口的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 | 是否需要打开净化器 |