开发指南

发布api对接文章到CSDN可联系客服领取10万次请求次数, 感谢您的支持

专业七日天气接口v91
查看报价 开通接口 在线测试接口(先登录)

v9升级版，返回数据更简洁, 默认隐藏了生活指数、小时数据和AQI指数, 可自定义展示, 可按地名、城市编号、IP查询、LBS查询。
相比v9增加了
  • ∞ 实时气象预警列表，可返回已发布的多条预警
  • ∞ 每日降雨量，例如：2.5mm
  • ∞ 降雨概率百分比，例如：30%
  • ∞ 天气情况短语，例如：大部分地区多云
  • ∞ 天气情况描述，例如：中雨。 最高 18ºC。 东北偏北 风 15 到 25 每 km / h 。 降雨几率 70%。 降雨量约 6 mm。
  • ∞ 紫外线数值，例如：7、强
  • ∞ 月出月落及月相，例如：04:28、残月
  • ∞ ext参数，默认隐藏了(生活指数、小时数据和AQI指数)，ext传对应标识可自定义输出。

地区权限 请求限制 使用方案 发票
全国所有市区县 每日2万次 350/一年 1400/永久 可开电子普票、专票
全国所有市区县 每日5万次 385/一年 1540/永久 可开电子普票、专票
全国所有市区县 每日10万次 454/一年 1819/永久 可开电子普票、专票
全国所有市区县 每日20万次 700/一年 2800/永久 可开电子普票、专票
全国所有市区县 每日50万次 1400/一年 5600/永久 可开电子普票、专票
全国所有市区县 每日百万~千万次 联系客服开通独享版本，最低12800/年 可开电子普票、专票

请求次数限制仅限于单个APPID每日请求次数不超规定范围，并不会限制使用的项目数量、App、设备及IP等。

请求方式及url：

  • 请求方式：GET

  • 接口地址：(请将线路地址设置在服务端, 为动态可修改的, 请勿在C端直连接口, 防止遇到网络问题导致程序异常。)

  • 线路1(推荐)：http://gfeljm.tianqiapi.com/api

请求示例

http://gfeljm.tianqiapi.com/api?unescape=1&version=v91&appid=&appsecret=&ext=&cityid=

请求参数说明：

参数名 必选 类型 说明 备注（示例）
appid 是 string 用户appid 注册开发账号
appsecret 是 string 用户appsecret
version 是 string 接口版本标识 固定值: v91 每个接口的version值都不一样
adcode 否 string 国家统计局城市ID 如：130200000000 请参考 全国统计用区划代码表
cityid 否 string 城市ID 请参考 城市ID列表
city 否 string 城市名称 不要带市和区; 如: 青岛、铁西
province 否 string 所在省 如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海
ip 否 string IP地址 查询IP所在城市天气
ext 否 string 自定义字段参数 如: hours,aqi,life  (hours:小时天气, life:生活指数, aqi:当日空气质量详情)
lng 否 String 经度 如: 119.545023 (需额外开通lbs权限, 500/年, 2000/永久)
lat 否 String 纬度 如: 36.044254
point 否 String 坐标体系 默认百度坐标, 如使用高德坐标, 请传参: gaode
callback 否 string jsonp参数 如: jQuery.Callbacks
vue 否 string 跨域参数 如果您使用的是react、vue、angular请填写值: 1
unescape 否 Int 是否转义中文 如果您希望json不被unicode, 直接输出中文, 请传此参数: 1

备注

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

响应JSON

{
    "cityid":"101050205",
    "city":"富裕",
    "cityEn":"fuyu",
    "country":"中国",
    "countryEn":"China",
    "update_time":"2021-05-08 21:25:24",
    "data":[
        {
            "day":"08日（星期六）",
            "date":"2021-05-08",
            "week":"星期六",
            "wea":"阴转多云",
            "wea_img":"yun",
            "wea_day":"阴",
            "wea_day_img":"yin",
            "wea_night":"多云",
            "wea_night_img":"yun",
            "tem":"12",
            "tem1":"13",
            "tem2":"5",
            "rain_pcpn":"2.8",#2.8mm
            "humidity":"30%",
            "visibility":"22.1km",
            "pressure":"977",
            "win":[
                "北风",
                "北风"
            ],
            "win_speed":"4-5级转<3级",
            "win_meter":"16-24km/h",
            "sunrise":"04:13",
            "sunset":"19:03",
            "air":"15",
            "air_level":"优",
            "air_tips":"",
            "phrase":"多云",
            "narrative":"阴。 最高 15ºC。 东北偏北 风 25 到 40 每 km / h 。",
            "moonrise":"03:14",
            "moonset":"15:18",
            "moonPhrase":"残月",
            "rain":"0",
            "uvIndex":"1",
            "uvDescription":"低",
            "alarm":[
                {
                    "alarm_type":"大风",
                    "alarm_level":"蓝色",
                    "alarm_title":"黑龙江省富裕县发布大风蓝色预警",
                    "alarm_content":"富裕县气象局2021年5月8日08时50分发布大风蓝色预警信号：未来24小时我县将受大风影响，平均风力5-6级，阵风可达7级，请有关单位和个人注意做好预防工作。（预警信息来源：国家预警信息发布中心）"
                },
                {
                    "alarm_type":"大风",
                    "alarm_level":"蓝色",
                    "alarm_title":"黑龙江省齐齐哈尔市发布大风蓝色预警",
                    "alarm_content":"齐齐哈尔市气象台2021年5月8日08时45分发布大风蓝色预警信号：预计未来24小时齐齐哈尔全区将受大风影响，平均风力5-6级，阵风可达7级，请注意预防。（预警信息来源：国家预警信息发布中心）"
                }
            ]
        },
        {
            "day":"09日（星期日）",
            "date":"2021-05-09",
            "week":"星期日",
            "wea":"多云",
            "wea_img":"yun",
            "wea_day":"多云",
            "wea_day_img":"yun",
            "wea_night":"多云",
            "wea_night_img":"yun",
            "tem":"15",
            "tem1":"15",
            "tem2":"6",
            "humidity":"33",
            "visibility":"",
            "pressure":"",
            "rain_pcpn":"0.0",
            "win":[
                "西北风",
                "西南风"
            ],
            "win_speed":"3-4级转<3级",
            "win_meter":"",
            "sunrise":"04:12",
            "sunset":"19:05",
            "air":"14",
            "air_level":"优",
            "air_tips":"",
            "phrase":"局部多云",
            "narrative":"少云。 最高 17ºC。 北 风 15 到 30 每 km / h 。",
            "moonrise":"03:30",
            "moonset":"16:22",
            "moonPhrase":"残月",
            "rain":"0",
            "uvIndex":"6",
            "uvDescription":"强"
        },
        {
            "day":"10日（星期一）",
            "date":"2021-05-10",
            "week":"星期一",
            "wea":"多云",
            "wea_img":"yun",
            "wea_day":"多云",
            "wea_day_img":"yun",
            "wea_night":"多云",
            "wea_night_img":"yun",
            "tem":"16",
            "tem1":"16",
            "tem2":"7",
            "humidity":"34",
            "visibility":"",
            "pressure":"",
            "win":[
                "西北风",
                "南风"
            ],
            "win_speed":"<3级",
            "win_meter":"",
            "sunrise":"04:10",
            "sunset":"19:06",
            "air":"25",
            "air_level":"优",
            "air_tips":"",
            "phrase":"局部多云",
            "narrative":"少云。 最高 20ºC。 南 风 10 到 15 每 km / h 。",
            "moonrise":"03:47",
            "moonset":"17:28",
            "moonPhrase":"残月",
            "rain":"8",
            "uvIndex":"6",
            "uvDescription":"强"
        },
        {
            "day":"11日（星期二）",
            "date":"2021-05-11",
            "week":"星期二",
            "wea":"小雨",
            "wea_img":"yu",
            "wea_day":"小雨",
            "wea_day_img":"yu",
            "wea_night":"小雨",
            "wea_night_img":"yu",
            "tem":"20",
            "tem1":"20",
            "tem2":"10",
            "humidity":"37",
            "visibility":"",
            "pressure":"",
            "win":[
                "南风",
                "东南风"
            ],
            "win_speed":"<3级",
            "win_meter":"",
            "sunrise":"04:09",
            "sunset":"19:07",
            "air":"19",
            "air_level":"优",
            "air_tips":"",
            "phrase":"多云",
            "narrative":"阴。 最高 21ºC。 东南偏南 风 25 到 40 每 km / h 。",
            "moonrise":"04:05",
            "moonset":"18:32",
            "moonPhrase":"新月",
            "rain":"24",
            "uvIndex":"4",
            "uvDescription":"中等"
        },
        {
            "day":"12日（星期三）",
            "date":"2021-05-12",
            "week":"星期三",
            "wea":"阵雨转晴",
            "wea_img":"yu",
            "wea_day":"阵雨",
            "wea_day_img":"yu",
            "wea_night":"晴",
            "wea_night_img":"qing",
            "tem":"18",
            "tem1":"18",
            "tem2":"9",
            "humidity":"44",
            "visibility":"",
            "pressure":"",
            "win":[
                "西北风",
                "西风"
            ],
            "win_speed":"<3级",
            "win_meter":"",
            "sunrise":"04:07",
            "sunset":"19:09",
            "air":"12",
            "air_level":"优",
            "air_tips":"",
            "phrase":"局部多云",
            "narrative":"少云。 最高 18ºC。 西南偏西 风 25 到 40 每 km / h 。",
            "moonrise":"04:26",
            "moonset":"19:39",
            "moonPhrase":"新月",
            "rain":"10",
            "uvIndex":"5",
            "uvDescription":"中等"
        },
        {
            "day":"13日（星期四）",
            "date":"2021-05-13",
            "week":"星期四",
            "wea":"多云转晴",
            "wea_img":"yun",
            "wea_day":"多云",
            "wea_day_img":"yun",
            "wea_night":"晴",
            "wea_night_img":"qing",
            "tem":"22",
            "tem1":"22",
            "tem2":"8",
            "humidity":"32",
            "visibility":"",
            "pressure":"",
            "win":[
                "西风",
                "东北风"
            ],
            "win_speed":"<3级",
            "win_meter":"",
            "sunrise":"04:06",
            "sunset":"19:10",
            "air":"12",
            "air_level":"优",
            "air_tips":"",
            "phrase":"局部多云",
            "narrative":"少云。 最高 23ºC。 西北偏西 风 15 到 25 每 km / h 。",
            "moonrise":"04:51",
            "moonset":"20:43",
            "moonPhrase":"娥眉月",
            "rain":"0",
            "uvIndex":"6",
            "uvDescription":"强"
        },
        {
            "day":"14日（星期五）",
            "date":"2021-05-14",
            "week":"星期五",
            "wea":"阵雨转多云",
            "wea_img":"yun",
            "wea_day":"阵雨",
            "wea_day_img":"yu",
            "wea_night":"多云",
            "wea_night_img":"yun",
            "tem":"16",
            "tem1":"16",
            "tem2":"9",
            "humidity":"39",
            "visibility":"",
            "pressure":"",
            "win":[
                "东风",
                "东风"
            ],
            "win_speed":"<3级",
            "win_meter":"",
            "sunrise":"04:05",
            "sunset":"19:11",
            "air":"8",
            "air_level":"优",
            "air_tips":"",
            "phrase":"局部多云",
            "narrative":"少云。 最高 20ºC。 西 风 15 到 30 每 km / h 。",
            "moonrise":"05:22",
            "moonset":"21:46",
            "moonPhrase":"娥眉月",
            "rain":"23",
            "uvIndex":"6",
            "uvDescription":"强"
        }
    ]
}

响应参数说明

参数名 类型 说明 备注
cityid String 城市ID
update_time String 气象台更新时间
city String 城市名称
cityEn String 城市英文名称
country String 国家名称
countryEn String 国家英文名称
data String 每日数据列表 1-7日，共7组
 ┗ wea String 天气情况1
 ┗ wea_img String 天气对应图标 固定9种类型(您也可以根据wea字段自己处理):
xue、lei、shachen、wu、bingbao、yun、yu、yin、qing
 ┗ phrase String 天气情况短语 例如：短时阵雨
 ┗ narrative String 天气情况描述 例如：少许阵雨。 最高 24ºC。 东北偏东 风 10 到 15 每 km / h 。 降雨几率 30%。
 ┗ tem String 实时温度
 ┗ tem1 String 高温
 ┗ tem2 String 低温
 ┗ win String 风向
 ┗ win_speed String 风力等级
 ┗ humidity String 湿度
 ┗ sunrise String 日出 例如：06:30
 ┗ sunset String 日出 例如：17:30
 ┗ moonrise String 月出 例如：05:09
 ┗ moonset String 月落 例如：19:06
 ┗ moonPhrase String 月相 例如：娥眉月
 ┗ rain_pcpn String 降雨量数值 例如：2.5, 单位：mm
 ┗ visibility String 能见度
 ┗ pressure String 气压hPa
 ┗ air String 空气质量
 ┗ air_level String 空气质量等级 优,良,轻度污染,中度污染,重度污染,严重污染
 ┗ air_tips String 空气质量描述(已废弃)
 ┗ rain String 降雨概率 例如：15，表示降雨概率15%
 ┗ uvIndex String 紫外线等级 例如：5
 ┗ uvDescription 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 是否需要打开净化器

新手上路

相关下载

关于我们


关注服务号

客服QQ：445899710 客服微信：hype522147 济南易客云网络科技有限公司 已稳定运行2781天
鲁ICP备20002338号