景点天气预报

数据介绍

全国4A和5A级景点共2000+的7天天气预报,包括:日出日落时间、最高最低温度、白天和晚间天气状况、风力、风向等。

请求URL

商业版:

https://api.heweather.net/s6/scenic?{parameters}

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

请注意,在替换{parameters}对应值的时候,URL中不要包含大括号{}

请求URL示例

# 获取北京天坛公园天气情况:
https://api.heweather.net/s6/scenic?location=CN10101010004A&key=xxx

请求参数

参数 描述 选择 示例值
location 景点天气仅支持使用景点ID获取数据
查看全部景点ID
必选 location=CN10101010004A
lang 多语言,可以不使用该参数,默认为简体中文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户认证key,请参考如何获取你的KEY
另外支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回参数和数值说明

basic基础信息

参数 描述 示例值
location 地区/城市名称 玉渊潭公园
cid 地区/城市ID CN10101020010A
lat 地区/城市纬度 39.90999
lon 地区/城市经度 116.30999
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

status接口状态

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

daily_forecast天气预报

参数 描述 示例
date 预报日期  
sr 日出时间 04:50
ss 日落时间 18:06
tmp_max 最高温度 4
tmp_min 最低温度 -5
cond_code_d 白天天气状况代码 100
cond_code_n 夜间天气状况代码 100
cond_txt_d 白天天气状况描述
cond_txt_n 晚间天气状况描述
wind_dir 风向
wind_sc 风力 2-3

数据返回示例

{
    "HeWeather6": [
        {
            "basic": {
                "cid": "CN10101020010A", 
                "location": "玉渊潭公园", 
                "parent_city": "北京", 
                "admin_area": "北京", 
                "cnty": "中国", 
                "lat": "39.90999985", 
                "lon": "116.30999756", 
                "tz": "+8.00"
            }, 
            "update": {
                "loc": "2019-06-05 22:18", 
                "utc": "2019-06-05 14:18"
            }, 
            "status": "ok", 
            "daily_forecast": [
                {
                    "cond_code_d": "104", 
                    "cond_code_n": "305", 
                    "cond_txt_d": "阴", 
                    "cond_txt_n": "小雨", 
                    "date": "2019-06-05", 
                    "sr": "04:46", 
                    "ss": "19:39", 
                    "tmp_max": "30", 
                    "tmp_min": "18", 
                    "wind_dir": "西南风", 
                    "wind_sc": "1-2"
                }, 
                {
                    "cond_code_d": "306", 
                    "cond_code_n": "101", 
                    "cond_txt_d": "中雨", 
                    "cond_txt_n": "多云", 
                    "date": "2019-06-06", 
                    "sr": "04:46", 
                    "ss": "19:40", 
                    "tmp_max": "26", 
                    "tmp_min": "16", 
                    "wind_dir": "南风", 
                    "wind_sc": "1-2"
                }, 
                {
                    "cond_code_d": "100", 
                    "cond_code_n": "100", 
                    "cond_txt_d": "晴", 
                    "cond_txt_n": "晴", 
                    "date": "2019-06-07", 
                    "sr": "04:46", 
                    "ss": "19:40", 
                    "tmp_max": "31", 
                    "tmp_min": "19", 
                    "wind_dir": "北风", 
                    "wind_sc": "1-2"
                }, 
                {
                    "cond_code_d": "100", 
                    "cond_code_n": "100", 
                    "cond_txt_d": "晴", 
                    "cond_txt_n": "晴", 
                    "date": "2019-06-08", 
                    "sr": "04:46", 
                    "ss": "19:41", 
                    "tmp_max": "33", 
                    "tmp_min": "18", 
                    "wind_dir": "北风", 
                    "wind_sc": "1-2"
                }, 
                {
                    "cond_code_d": "101", 
                    "cond_code_n": "104", 
                    "cond_txt_d": "多云", 
                    "cond_txt_n": "阴", 
                    "date": "2019-06-09", 
                    "sr": "04:45", 
                    "ss": "19:41", 
                    "tmp_max": "34", 
                    "tmp_min": "19", 
                    "wind_dir": "东风", 
                    "wind_sc": "1-2"
                }, 
                {
                    "cond_code_d": "104", 
                    "cond_code_n": "305", 
                    "cond_txt_d": "阴", 
                    "cond_txt_n": "小雨", 
                    "date": "2019-06-10", 
                    "sr": "04:45", 
                    "ss": "19:42", 
                    "tmp_max": "34", 
                    "tmp_min": "18", 
                    "wind_dir": "东南风", 
                    "wind_sc": "1-2"
                }, 
                {
                    "cond_code_d": "305", 
                    "cond_code_n": "101", 
                    "cond_txt_d": "小雨", 
                    "cond_txt_n": "多云", 
                    "date": "2019-06-11", 
                    "sr": "04:45", 
                    "ss": "19:42", 
                    "tmp_max": "29", 
                    "tmp_min": "18", 
                    "wind_dir": "东北风", 
                    "wind_sc": "1-2"
                }
            ]
        }
    ]
}