常规天气数据集合

接口介绍

本接口包含了3-7天天气预报、实况天气、逐小时天气预报以及生活指数,有对应权限的用户可通过访问此接口一次性获取某一地区的上述所有天气数据

  • 普通用户通过此接口仅获得3天预报数据,认证个人开发者可获取7天预报和24小时内逐3小时预报数据,实况数据以及免费的生活指数,有权限的付费用户则可获得对应权限的全部数据
  • 本集合接口中,生活指数仅限国内地区,如查询海外城市,则该数据字段将不提供

请求URL

付费:https://api.heweather.com/s6/weather?parameters

免费:https://free-api.heweather.com/s6/weather?parameters

parameters代表请求参数,包括必选和可选参数。所有请求参数均使用&进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请求参数

参数 描述 选择 示例值
location 需要查询的城市或地区,可输入以下值:
1. 城市ID:城市列表
2. 经纬度格式:经度,纬度(经度在前纬度在后,英文,分隔,十进制格式,北纬东经为正,南纬西经为负
3. 城市名称,支持中英文和汉语拼音
4. 城市名称,上级城市 或 省 或 国家,英文,分隔,此方式可以在重名的情况下只获取想要的地区的天气数据,例如 西安,陕西
5. IP
6. 根据请求自动判断,根据用户的请求获取IP,通过 IP 定位并获取城市数据
必选 1. location=CN101010100
2. location=116.40,39.9
3. location=北京、 location=北京市、 location=beijing
4. location=朝阳,北京、 location=chaoyang,beijing
5. location=60.194.130.1
6. location=auto_ip
lang 多语言,可以不使用该参数,默认为简体中文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户认证key,登录控制台可查看
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回字段和数值说明

basic 基础信息

参数 描述 示例值
location 地区/城市名称 卓资
cid 地区/城市ID CN101080402
lat 地区/城市纬度 40.89576
lon 地区/城市经度 112.577702
parent_city 该地区/城市的上级城市 乌兰察布
admin_area 该地区/城市所属行政区域 内蒙古
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

update 接口更新时间

参数 描述 示例值
loc 当地时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 12:34
utc UTC时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 04:34

daily_forecast 天气预报

参数 描述 示例值
date 预报日期 2013-12-30
sr 日出时间 07:36
ss 日落时间 16:58
mr 月升时间 04:47
ms 月落时间 14:59
tmp_max 最高温度 4
tmp_min 最低温度 -5
cond_code_d 白天天气状况代码 100
cond_code_n 晚间天气状况代码 100
cond_txt_d 白天天气状况描述
cond_txt_n 晚间天气状况描述
wind_deg 风向360角度 310
wind_dir 风向 西北风
wind_sc 风力 1-2
wind_spd 风速,公里/小时 14
hum 相对湿度 37
pcpn 降水量 0
pop 降水概率 0
pres 大气压强 1018
uv_index 紫外线强度指数 3
vis 能见度,单位:公里 10

now 实况天气

参数 描述 示例
fl 体感温度,默认单位:摄氏度 23
tmp 温度,默认单位:摄氏度 21
cond_code 实况天气状况代码 100
cond_txt 实况天气状况描述
wind_deg 风向360角度 305
wind_dir 风向 西北
wind_sc 风力 3-4
wind_spd 风速,公里/小时 15
hum 相对湿度 40
pcpn 降水量 0
pres 大气压强 1020
vis 能见度,默认单位:公里 10
cloud 云量 23

hourly 逐小时预报

参数 描述 示例
time 预报时间,格式yyyy-MM-dd hh:mm 2013-12-30 13:00
tmp 温度 2
cond_code 天气状况代码 101
cond_txt 天气状况代码 多云
wind_deg 风向360角度 290
wind_dir 风向 西北
wind_sc 风力 3-4
wind_spd 风速,公里/小时 15
hum 相对湿度 30
pres 大气压强 1030
dew 露点温度 12
cloud 云量 23

lifestyle 生活指数

参数 描述
brf 生活指数简介
txt 生活指数详细描述
type 生活指数类型 comf:舒适度指数、cw:洗车指数、drsg:穿衣指数、flu:感冒指数、sport:运动指数、trav:旅游指数、uv:紫外线指数、air:空气污染扩散条件指数、ac:空调开启指数、ag:过敏指数、gl:太阳镜指数、mu:化妆指数、airc:晾晒指数、ptfc:交通指数、fisin:钓鱼指数、spi:防晒指数

lifestyle_forecast 生活指数未来3天预报

参数 描述
date 预报日期,例如2017-12-30
brf 生活指数简介
txt 生活指数详细描述
type 生活指数类型 comf:舒适度指数、cw:洗车指数、drsg:穿衣指数、flu:感冒指数、sport:运动指数、trav:旅游指数、uv:紫外线指数、air:空气污染扩散条件指数、ac:空调开启指数、ag:过敏指数、gl:太阳镜指数、mu:化妆指数、airc:晾晒指数、ptfc:交通指数、fisin:钓鱼指数、spi:防晒指数

satuts 接口状态

参数 描述 示例值
status 接口状态,具体含义请参考接口状态码及错误码 ok

数据返回示例

{
    "HeWeather6": [
        {
            "basic": {
                "cid": "CN101010100",
                "location": "北京",
                "parent_city": "北京",
                "admin_area": "北京",
                "cnty": "中国",
                "lat": "39.90498734",
                "lon": "116.40528870",
                "tz": "8.0"
            },
            "daily_forecast": [
                {
                    "cond_code_d": "103",
                    "cond_code_n": "101",
                    "cond_txt_d": "晴间多云",
                    "cond_txt_n": "多云",
                    "date": "2017-10-26",
                    "hum": "57",
                    "pcpn": "0.0",
                    "pop": "0",
                    "pres": "1020",
                    "tmp_max": "16",
                    "tmp_min": "8",
                    "uv_index": "3",
                    "vis": "16",
                    "wind_deg": "0",
                    "wind_dir": "无持续风向",
                    "wind_sc": "微风",
                    "wind_spd": "5"
                },
                {
                    "cond_code_d": "101",
                    "cond_code_n": "501",
                    "cond_txt_d": "多云",
                    "cond_txt_n": "雾",
                    "date": "2017-10-27",
                    "hum": "56",
                    "pcpn": "0.0",
                    "pop": "0",
                    "pres": "1018",
                    "tmp_max": "18",
                    "tmp_min": "9",
                    "uv_index": "3",
                    "vis": "20",
                    "wind_deg": "187",
                    "wind_dir": "南风",
                    "wind_sc": "微风",
                    "wind_spd": "6"
                },
                {
                    "cond_code_d": "101",
                    "cond_code_n": "101",
                    "cond_txt_d": "多云",
                    "cond_txt_n": "多云",
                    "date": "2017-10-28",
                    "hum": "26",
                    "pcpn": "0.0",
                    "pop": "0",
                    "pres": "1029",
                    "tmp_max": "17",
                    "tmp_min": "5",
                    "uv_index": "2",
                    "vis": "20",
                    "wind_deg": "2",
                    "wind_dir": "北风",
                    "wind_sc": "3-4",
                    "wind_spd": "19"
                }
            ],
            "hourly": [
                {
                    "cloud": "8",
                    "cond_code": "100",
                    "cond_txt": "晴",
                    "hum": "84",
                    "pop": "0",
                    "pres": "1018",
                    "time": "2017-10-27 01:00",
                    "tmp": "8",
                    "wind_deg": "49",
                    "wind_dir": "东北风",
                    "wind_sc": "微风",
                    "wind_spd": "2"
                },
                {
                    "cloud": "8",
                    "cond_code": "100",
                    "cond_txt": "晴",
                    "hum": "81",
                    "pop": "0",
                    "pres": "1018",
                    "time": "2017-10-27 04:00",
                    "tmp": "8",
                    "wind_deg": "29",
                    "wind_dir": "东北风",
                    "wind_sc": "微风",
                    "wind_spd": "2"
                },
                {
                    "cloud": "6",
                    "cond_code": "100",
                    "cond_txt": "晴",
                    "hum": "95",
                    "pop": "0",
                    "pres": "1019",
                    "time": "2017-10-27 07:00",
                    "tmp": "8",
                    "wind_deg": "37",
                    "wind_dir": "东北风",
                    "wind_sc": "微风",
                    "wind_spd": "2"
                },
                {
                    "cloud": "2",
                    "cond_code": "100",
                    "cond_txt": "晴",
                    "hum": "75",
                    "pop": "0",
                    "pres": "1018",
                    "time": "2017-10-27 10:00",
                    "tmp": "14",
                    "wind_deg": "108",
                    "wind_dir": "东南风",
                    "wind_sc": "微风",
                    "wind_spd": "3"
                },
                {
                    "cloud": "0",
                    "cond_code": "100",
                    "cond_txt": "晴",
                    "hum": "62",
                    "pop": "0",
                    "pres": "1016",
                    "time": "2017-10-27 13:00",
                    "tmp": "16",
                    "wind_deg": "158",
                    "wind_dir": "东南风",
                    "wind_sc": "微风",
                    "wind_spd": "6"
                },
                {
                    "cloud": "0",
                    "cond_code": "100",
                    "cond_txt": "晴",
                    "hum": "73",
                    "pop": "0",
                    "pres": "1016",
                    "time": "2017-10-27 16:00",
                    "tmp": "15",
                    "wind_deg": "162",
                    "wind_dir": "东南风",
                    "wind_sc": "微风",
                    "wind_spd": "6"
                },
                {
                    "cloud": "3",
                    "cond_code": "100",
                    "cond_txt": "晴",
                    "hum": "92",
                    "pop": "0",
                    "pres": "1018",
                    "time": "2017-10-27 19:00",
                    "tmp": "13",
                    "wind_deg": "206",
                    "wind_dir": "西南风",
                    "wind_sc": "微风",
                    "wind_spd": "4"
                },
                {
                    "cloud": "19",
                    "cond_code": "100",
                    "cond_txt": "晴",
                    "hum": "96",
                    "pop": "0",
                    "pres": "1019",
                    "time": "2017-10-27 22:00",
                    "tmp": "13",
                    "wind_deg": "212",
                    "wind_dir": "西南风",
                    "wind_sc": "微风",
                    "wind_spd": "1"
                }
            ],
            "lifestyle": [
                {
                    "brf": "舒适",
                    "txt": "今天夜间不太热也不太冷,风力不大,相信您在这样的天气条件下,应会感到比较清爽和舒适。",
                    "type": "comf"
                },
                {
                    "brf": "较舒适",
                    "txt": "建议着薄外套、开衫牛仔衫裤等服装。年老体弱者应适当添加衣物,宜着夹克衫、薄毛衣等。",
                    "type": "drsg"
                },
                {
                    "brf": "少发",
                    "txt": "各项气象条件适宜,无明显降温过程,发生感冒机率较低。",
                    "type": "flu"
                },
                {
                    "brf": "适宜",
                    "txt": "天气较好,赶快投身大自然参与户外运动,尽情感受运动的快乐吧。",
                    "type": "sport"
                },
                {
                    "brf": "适宜",
                    "txt": "天气较好,但丝毫不会影响您出行的心情。温度适宜又有微风相伴,适宜旅游。",
                    "type": "trav"
                },
                {
                    "brf": "弱",
                    "txt": "紫外线强度较弱,建议出门前涂擦SPF在12-15之间、PA+的防晒护肤品。",
                    "type": "uv"
                },
                {
                    "brf": "较不宜",
                    "txt": "较不宜洗车,未来一天无雨,风力较大,如果执意擦洗汽车,要做好蒙上污垢的心理准备。",
                    "type": "cw"
                },
                {
                    "brf": "较差",
                    "txt": "气象条件较不利于空气污染物稀释、扩散和清除,请适当减少室外活动时间。",
                    "type": "air"
                }
            ],
            "now": {
                "cond_code": "501",
                "cond_txt": "雾",
                "fl": "8",
                "hum": "94",
                "pcpn": "0",
                "pres": "1018",
                "tmp": "9",
                "vis": "2",
                "wind_deg": "48",
                "wind_dir": "东北风",
                "wind_sc": "微风",
                "wind_spd": "7"
            },
            "status": "ok",
            "update": {
                "loc": "2017-10-26 23:09",
                "utc": "2017-10-26 15:09"
            }
        }
    ]
}