开发指南

新用户可测试2000次

专业实况天气接口在线测试此接口(需要登录)


行政中心5分钟更新一次, 县级市区25分钟更新一次,包含基本天气信息、气象预警、湿度、能见度、气压、日出日落、6大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等,可按地名、城市编号、IP查询。

请求方式及url:

  • 请求方式:GET

  • 接口地址:https://yiketianqi.com/api

请求示例

https://yiketianqi.com/api?version=v61&appid=&appsecret=

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
version string 接口版本标识 固定值: v61 每个接口的version值都不一样
cityid string 城市ID 请参考 城市ID列表
city string 城市名称 不要带市和区; 如: 青岛、铁西
ip string IP地址 查询IP所在城市天气
lng String 经度 如: 119.545023 (需开通lbs权限)
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":"101271201", #城市编号
    "date":"2020-07-15",
    "week":"星期三",
    "update_time":"10:15", #更新时间
    "city":"内江", #城市名称
    "cityEn":"neijiang",
    "country":"中国",
    "countryEn":"China",
    "wea":"阴", #实时天气情况
    "wea_img":"yin",
    "tem":"25", #实时温度
    "tem1":"29", #高温
    "tem2":"23", #低温
    "win":"西风", #风向
    "win_speed":"2级", #风力等级
    "win_meter":"小于12km/h", #风速
    "humidity":"97%", #湿度
    "visibility":"24.22km", #能见度
    "pressure":"961", #气压
    "air":"15", #空气质量
    "air_pm25":"8", #pm2.5
    "air_level":"优",
    "air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!",
    "alarm":{
        "alarm_type":"暴雨",  #预警类型
        "alarm_level":"橙色", #预警等级
        "alarm_content":"内江市气象台7月15日5时23分发布第16号暴雨橙色预警信号:
   预计我市市中区部分地方3小时降雨量将达50毫米以上,并伴有雷电和阵性大风,请加强防范强降水、雷电和大风等带来的危害。
(预警信息来源:国家预警信息发布中心)" #预警描述
    },
    "aqi":{ #空气质量指数详情
        "air":"15",
        "air_level":"优",
        "air_tips":"空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!",
        "pm25":"8",
        "pm25_desc":"优",
        "pm10":"10",
        "pm10_desc":"优",
        "o3":"47",
        "o3_desc":"优",
        "no2":"12",
        "no2_desc":"优",
        "so2":"8",
        "so2_desc":"优",
        "kouzhao":"无需戴口罩",
        "waichu":"适宜外出",
        "kaichuang":"适宜开窗",
        "jinghuaqi":"关闭净化器",
        "cityid":"101271201",
        "city":"内江",
        "cityEn":"neijiang",
        "country":"中国",
        "countryEn":"China"
    }
}

响应参数说明

参数名 类型 说明 备注
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 空气质量描述
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 是否需要打开净化器