开发指南

新用户可测试2000次 比某度更精准、及时,请进入气象台网站对比数据

专业七日天气接口v91


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

地区权限 请求限制 使用方案 发票
全国所有市区县 每日2万次 170/一年(最低) 680/五年(最低) 1326/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日5万次 300/一年(最低) 1200/五年(最低) 2340/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日10万次 550/一年(最低) 2200/五年(最低) 4290/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日20万次 1500/一年(最低) 6000/五年(最低) 11700/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日50万次 3000/一年(最低) 12000/五年(最低) 23400/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日百万~千万次 联系客服开通独享版本,最低9800/年 可开普票/电子票/专票
请求次数限制仅限于单个APPID每日请求次数不超规定范围,并不会限制使用的项目数量、App、设备及IP等。

请求方式及url:

  • 请求方式:GET

  • 接口地址:(建议将线路地址设置在服务端可动态修改)

  • 线路1(推荐)https://v0.yiketianqi.com/api

请求示例

https://v0.yiketianqi.com/api?version=v91&appid=&appsecret=&ext=&cityid=

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
version string 接口版本标识 固定值: v91 每个接口的version值都不一样
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/5年)
lat String 纬度 如: 36.044254
point String 坐标体系 默认百度坐标, 如使用高德坐标, 请传参: gaode
callback string jsonp参数 如: jQuery.Callbacks
vue string 跨域参数 如果您使用的是react、vue、angular请填写值: 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",
            "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":"",
            "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 月相 例如:19:06
 ┗ 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 是否需要打开净化器