地区权限 请求限制 使用方案 发票 全国所有市区县 每日100次左右 个人免费使用3个月 全国所有市区县 每日2万次 400/一年 1800/永久 可开普票/电子票/专票 全国所有市区县 每日5万次 700/一年 2800/永久 可开普票/电子票/专票 全国所有市区县 每日10万次 1000/一年 4000/永久 可开普票/电子票/专票 全国所有市区县 每日20万次 2000/一年 8000/永久 可开普票/电子票/专票 全国所有市区县 每日50万次 4000/一年 20000/永久 可开普票/电子票/专票 全国所有市区县 每日百万~千万次 联系客服开通独享版本,最低12800/年 可开普票/电子票/专票 请求次数限制仅限于单个APPID每日请求次数不超规定范围,并不会限制使用的项目数量、App、设备及IP等。
请求方式及url:
请求方式:GET
接口地址:(请将线路地址设置在服务端, 为动态可修改的, 请勿在C端直连接口, 防止遇到网络问题导致程序异常。)
线路1(推荐):http://gfeljm.tianqiapi.com/free/v2030请求示例
http://gfeljm.tianqiapi.com/free/v2030?city=&cityid=&adcode=130200000000&appid=&appsecret=&lng=&lat=&aqi=&hours=
请求参数说明:
参数名 必选 类型 说明 备注(示例) appid 是 string 用户appid 注册开发账号 appsecret 是 string 用户appsecret adcode 否 string 国家统计局城市ID 如:130200000000 请参考 全国统计用区划代码表 cityid 否 string 城市ID 请参考 城市ID列表 city 否 string 城市名称 不要带市和区; 如: 青岛、铁西 province 否 string 所在省 如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海 ip 否 string IP地址 查询IP所在城市天气 lng 否 String 经度 如: 119.545023 (免费使用,无需额外开通) lat 否 String 纬度 如: 36.044254 point 否 String 坐标体系 默认百度坐标, 如使用高德坐标, 请传参: gaode hours 否 Int 小时天气 默认隐藏, 如需显示, 请传参: 1 aqi 否 Int AQI六因子 默认隐藏, 如需显示, 请传参: 1 callback 否 string jsonp参数 如: jQuery.Callbacks vue 否 string 跨域参数 如果您使用的是react、vue、angular请填写值: 1备注
cityid、adcode、city、经纬度和ip参数5选一提交即可,如果不传,默认返回当前ip城市天气,cityid优先级最高。
响应JSON
{ "cityid":"101020500", "date":"2023-08-12", "week":"星期四", "update_time":"11:18", "city":"嘉定", "cityEn":"jiading", "country":"中国", "countryEn":"China", "wea":"多云", "wea_img":"yun", "tem":"30", "tem1":"28", "tem2":"25", "win":"东北风", "win_speed":"2级", "win_meter":"7km/h", "humidity":"74%", "visibility":"30km", "pressure":"1006", "rain_pcpn":"2.5",#降雨量2.5mm "air":"42", "air_pm25":"14", "air_level":"优", "air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!", "alarm":[ { "alarm_type":"雷电", "alarm_level":"黄色", "alarm_title":"上海市嘉定区发布雷电黄色预警", "alarm_content":"嘉定区气象局2023年08月12日11时05分发布雷电黄色预警[Ⅲ级/较重]:预计今天半夜以前我区将出现雷电活动,局地可能伴有1小时最大雨强40-60mm的短时强降水,请加强防范。(预警信息来源:国家预警信息发布中心)" }, { "alarm_type":"雷电", "alarm_level":"黄色", "alarm_title":"上海市发布雷电黄色预警", "alarm_content":"上海中心气象台2023年08月12日11时00分发布雷电黄色预警[Ⅲ级/较重]:预计今天半夜以前本市大部地区将出现雷电活动,局地可能伴有1小时最大雨强40-60mm的短时强降水,请加强防范。(预警信息来源:国家预警信息发布中心)" } ], "wea_day":"小雨", "wea_day_img":"yu", "wea_night":"小雨", "wea_night_img":"yu", "sunrise":"05:17", "sunset":"18:42", "hours":[ { "hours":"现在", "wea":"小雨", "wea_img":"yu", "tem":"27", "win":"东南风", "win_speed":"1级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"12:00", "wea":"小雨", "wea_img":"yu", "tem":"28", "win":"东风", "win_speed":"2级", "vis":"14.5", "aqi":"优", "aqinum":"" }, { "hours":"13:00", "wea":"小雨", "wea_img":"yu", "tem":"28", "win":"东北风", "win_speed":"1级", "vis":"13", "aqi":"优", "aqinum":"" }, { "hours":"14:00", "wea":"小雨", "wea_img":"yu", "tem":"28", "win":"东北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"15:00", "wea":"小雨", "wea_img":"yu", "tem":"28", "win":"东北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"16:00", "wea":"小雨", "wea_img":"yu", "tem":"28", "win":"东北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"17:00", "wea":"小雨", "wea_img":"yu", "tem":"27", "win":"东北风", "win_speed":"3级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"18:00", "wea":"小雨", "wea_img":"yu", "tem":"27", "win":"东北风", "win_speed":"3级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"19:00", "wea":"小雨", "wea_img":"yu", "tem":"27", "win":"东北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"20:00", "wea":"小雨", "wea_img":"yu", "tem":"26", "win":"东北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"21:00", "wea":"阴转多云", "wea_img":"yun", "tem":"26", "win":"东北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"22:00", "wea":"阴转多云", "wea_img":"yun", "tem":"25", "win":"东北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"23:00", "wea":"小雨", "wea_img":"yu", "tem":"25", "win":"东北风", "win_speed":"2级", "aqi":"优", "aqinum":"" }, { "hours":"08/13", "wea":"小雨", "wea_img":"yu", "tem":"25", "win":"东北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"01:00", "wea":"小雨", "wea_img":"yu", "tem":"25", "win":"东北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"02:00", "wea":"小雨", "wea_img":"yu", "tem":"25", "win":"北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"03:00", "wea":"阴转多云", "wea_img":"yun", "tem":"25", "win":"北风", "win_speed":"2级", "vis":"16", "aqi":"优", "aqinum":"" }, { "hours":"04:00", "wea":"阴转多云", "wea_img":"yun", "tem":"25", "win":"东北风", "win_speed":"2级", "vis":"13", "aqi":"优", "aqinum":"" }, { "hours":"05:00", "wea":"小雨", "wea_img":"yu", "tem":"25", "win":"东北风", "win_speed":"2级", "vis":"13.4", "aqi":"优", "aqinum":"" }, { "hours":"06:00", "wea":"小雨", "wea_img":"yu", "tem":"25", "win":"东北风", "win_speed":"3级", "vis":"13.5", "aqi":"优", "aqinum":"" }, { "hours":"07:00", "wea":"小雨", "wea_img":"yu", "tem":"25", "win":"北风", "win_speed":"2级", "vis":"13.6", "aqi":"优", "aqinum":"" }, { "hours":"08:00", "wea":"小雨", "wea_img":"yu", "tem":"25", "win":"北风", "win_speed":"2级", "vis":"13", "aqi":"优", "aqinum":"" }, { "hours":"09:00", "wea":"小雨", "wea_img":"yu", "tem":"26", "win":"北风", "win_speed":"3级", "vis":"13", "aqi":"优", "aqinum":"" } ], "aqi":{ "update_time":"10:29", "air":"42", "air_level":"优", "air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!", "pm25":"14", "pm25_desc":"优", "pm10":"42", "pm10_desc":"优", "o3":"23", "o3_desc":"优", "no2":"45", "no2_desc":"优", "so2":"2", "so2_desc":"优", "co":"-", "co_desc":"-", "kouzhao":"不用佩戴口罩", "yundong":"非常适宜运动", "waichu":"适宜外出", "kaichuang":"适宜开窗", "jinghuaqi":"关闭净化器" }}响应参数说明
参数名 类型 说明 备注 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 rain_pcpn String 今日降雨量数值 例如:2.5, 单位:mm air String 空气质量 air_level String 空气质量等级 优,良,轻度污染,中度污染,重度污染,严重污染 air_tips String 空气质量描述 alarm String 气象预警 ┗ alarm_type String 预警类型 ┗ alarm_level String 预警级别 ┗ alarm_level 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 是否需要打开净化器