该接口最快3小时更新一次,包含基本天气信息、湿度、能见度、气压、空气质量指数等,可按地名、城市编号、IP查询。
请求方式及url:
请求方式:GET
接口地址:https://tianqiapi.com/api
请求示例
https://tianqiapi.com/api?version=v6&appid=&appsecret=
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: v6 每个接口的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 | |
date | String | 当前日期 | |
week | String | 当前星期 | |
update_time | String | 气象台更新时间 | |
city | String | 城市名称 | |
cityEn | String | 城市英文名称 | |
country | String | 国家名称 | |
countryEn | String | 国家英文名称 | |
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 | 风力等级 | |
win_meter | String | 风速 | |
humidity | String | 湿度 | |
visibility | String | 能见度 | |
pressure | String | 气压hPa | |
air | String | 空气质量 | |
air_level | String | 空气质量等级 | |
air_tips | String | 空气质量描述 |