开发指南

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

专业实况天气接口v63
查看接口报价及开通 在线测试接口(先登录)

5分钟更新一次，包含基本天气信息、24小时逐小时天气、实时气象预警列表、湿度、能见度、气压、日出日落、9大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等，可按地名、城市编号、IP查询。
相比v61增加了：24小时逐小时天气、每小时空气质量、日出日落、白天和晚上天气情况。
相比v62去掉了：9大常用生活指数数据。
新增：优化预警字段, 返回实时预警数组, 5分钟更新一次数据源, 可同时出现多个预警, 可参考文档下方JSON。

地区权限 请求限制 使用方案 发票
全国所有市区县 每日10万次 500/一年(最低) 2000/永久(最低) 可提供普票、电子票、专票
全国所有市区县 每日百万~千万次 联系客服开通独享版本，最低12800/年 可开普票/电子票/专票

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

请求方式及url：

  • 请求方式：GET

  • 接口地址：(请将线路地址设置为动态可修改的)

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

  • 线路4：https://yiketianqi.com/api

请求示例

https://v0.yiketianqi.com/api?unescape=1&version=v63&appid=&appsecret=

请求参数说明：

参数名 必选 类型 说明 备注（示例）
appid 是 string 用户appid 注册开发账号
appsecret 是 string 用户appsecret
version 是 string 接口版本标识 固定值: v63 每个接口的version值都不一样
cityid 否 string 城市ID 请参考 城市ID列表
city 否 string 城市名称 不要带市和区; 如: 青岛、铁西
province 否 string 所在省 如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海
ip 否 string IP地址 查询IP所在城市天气
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
unescape 否 Int 是否转义中文 如果您希望json不被unicode, 直接输出中文, 请传此参数: 1

备注

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

响应JSON

{
    "cityid":"101020500",
    "date":"2021-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",
    "air":"42",
    "air_pm25":"14",
    "air_level":"优",
    "air_tips":"空气很好，可以外出活动，呼吸新鲜空气，拥抱大自然！",
    "alarm":[
        {
            "alarm_type":"雷电",
            "alarm_level":"黄色",
            "alarm_title":"上海市嘉定区发布雷电黄色预警",
            "alarm_content":"嘉定区气象局2021年08月12日11时05分发布雷电黄色预警[Ⅲ级/较重]：预计今天半夜以前我区将出现雷电活动，局地可能伴有1小时最大雨强40-60mm的短时强降水，请加强防范。（预警信息来源：国家预警信息发布中心）"
        },
        {
            "alarm_type":"雷电",
            "alarm_level":"黄色",
            "alarm_title":"上海市发布雷电黄色预警",
            "alarm_content":"上海中心气象台2021年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级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"12:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"28",
            "win":"东风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"13:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"28",
            "win":"东北风",
            "win_speed":"1级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"14:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"28",
            "win":"东北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"15:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"28",
            "win":"东北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"16:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"28",
            "win":"东北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"17:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"27",
            "win":"东北风",
            "win_speed":"3级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"18:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"27",
            "win":"东北风",
            "win_speed":"3级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"19:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"27",
            "win":"东北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"20:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"26",
            "win":"东北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"21:00",
            "wea":"阴转多云",
            "wea_img":"yun",
            "tem":"26",
            "win":"东北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"22:00",
            "wea":"阴转多云",
            "wea_img":"yun",
            "tem":"25",
            "win":"东北风",
            "win_speed":"2级",
            "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级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"01:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"25",
            "win":"东北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"02:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"25",
            "win":"北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"03:00",
            "wea":"阴转多云",
            "wea_img":"yun",
            "tem":"25",
            "win":"北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"04:00",
            "wea":"阴转多云",
            "wea_img":"yun",
            "tem":"25",
            "win":"东北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"05:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"25",
            "win":"东北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"06:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"25",
            "win":"东北风",
            "win_speed":"3级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"07:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"25",
            "win":"北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"08:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"25",
            "win":"北风",
            "win_speed":"2级",
            "aqi":"优",
            "aqinum":""
        },
        {
            "hours":"09:00",
            "wea":"小雨",
            "wea_img":"yu",
            "tem":"26",
            "win":"北风",
            "win_speed":"3级",
            "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":"关闭净化器"
    }
}

新手上路

相关下载

关于我们


关注服务号

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