格点7天预报

GETweather/grid-forecast

接口介绍

由和风天气、中国气象局、清华大学联合研发的我国首个精确到1公里格点的全国天气预报数据,最多可支持未来7天预报数据,包括:最高、最低温度,白天、夜间天气状况,白天、夜间风力风向等

仅限付费用户使用

请求URL

https://api.heweather.com/s6/weather/grid-forecast?parameters

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

请求参数

参数 描述 选择 示例值
location 需要查询的地区,仅可使用经纬度坐标查询
经纬度格式:经度,纬度(经度在前纬度在后,英文,分隔,十进制格式,北纬东经为正,南纬西经为负
必选 location=116.40,39.9
lang 多语言,可以不使用该参数,默认为简体中文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户认证key,登录控制台可查看
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

返回字段和数值说明

basic 基础信息

参数 描述 示例值
lat 地区/城市纬度 39.956074
lon 地区/城市经度 116.310316
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

grid_forecast 未来7天格点天气预报

参数 描述 示例值
date 预报日期,格式yyyy-MM-dd 2013-12-30
tmp_max 最高温度 4
tmp_min 最低温度 -5
cond_code_d 白天天气状况代码 100
cond_code_n 晚间天气状况代码 100
cond_txt_d 白天天气状况描述
cond_txt_n 晚间天气状况描述
wind_dir_d 白天风向 西北
wind_dir_n 夜间风向 西北
wind_sc_d 白天风力 3-4
wind_sc_n 夜间风力 3-4

数据返回示例

{
    "HeWeather6": [
        {
            "basic": {
                "admin_area": "北京",
                "cnty": "中国",
                "lat": "39.90",
                "lon": "116.40",
                "parent_city": "北京",
                "tz": "+8.0"
            },
            "grid_forecast": [
                {
                    "cond_code_d": "100",
                    "cond_code_n": "101",
                    "cond_txt_d": "晴",
                    "cond_txt_n": "多云",
                    "date": "2018-04-17",
                    "tmp_max": "24",
                    "tmp_min": "12",
                    "wind_dir_d": "北风",
                    "wind_dir_n": "北风",
                    "wind_sc_d": "1-2",
                    "wind_sc_n": "1-2"
                },
                {
                    "cond_code_d": "100",
                    "cond_code_n": "101",
                    "cond_txt_d": "晴",
                    "cond_txt_n": "多云",
                    "date": "2018-04-18",
                    "tmp_max": "26",
                    "tmp_min": "14",
                    "wind_dir_d": "北风",
                    "wind_dir_n": "北风",
                    "wind_sc_d": "1-2",
                    "wind_sc_n": "1-2"
                },
                {
                    "cond_code_d": "101",
                    "cond_code_n": "101",
                    "cond_txt_d": "多云",
                    "cond_txt_n": "多云",
                    "date": "2018-04-19",
                    "tmp_max": "26",
                    "tmp_min": "14",
                    "wind_dir_d": "北风",
                    "wind_dir_n": "北风",
                    "wind_sc_d": "1-2",
                    "wind_sc_n": "1-2"
                },
                {
                    "cond_code_d": "104",
                    "cond_code_n": "305",
                    "cond_txt_d": "阴",
                    "cond_txt_n": "小雨",
                    "date": "2018-04-20",
                    "tmp_max": "24",
                    "tmp_min": "16",
                    "wind_dir_d": "北风",
                    "wind_dir_n": "北风",
                    "wind_sc_d": "1-2",
                    "wind_sc_n": "1-2"
                },
                {
                    "cond_code_d": "305",
                    "cond_code_n": "305",
                    "cond_txt_d": "小雨",
                    "cond_txt_n": "小雨",
                    "date": "2018-04-21",
                    "tmp_max": "21",
                    "tmp_min": "7",
                    "wind_dir_d": "北风",
                    "wind_dir_n": "北风",
                    "wind_sc_d": "1-2",
                    "wind_sc_n": "1-2"
                },
                {
                    "cond_code_d": "101",
                    "cond_code_n": "101",
                    "cond_txt_d": "多云",
                    "cond_txt_n": "多云",
                    "date": "2018-04-22",
                    "tmp_max": "20",
                    "tmp_min": "8",
                    "wind_dir_d": "北风",
                    "wind_dir_n": "北风",
                    "wind_sc_d": "1-2",
                    "wind_sc_n": "1-2"
                },
                {
                    "cond_code_d": "104",
                    "cond_code_n": "104",
                    "cond_txt_d": "阴",
                    "cond_txt_n": "阴",
                    "date": "2018-04-23",
                    "tmp_max": "23",
                    "tmp_min": "9",
                    "wind_dir_d": "北风",
                    "wind_dir_n": "北风",
                    "wind_sc_d": "1-2",
                    "wind_sc_n": "1-2"
                }
            ],
            "status": "ok",
            "update": {
                "loc": "2018-04-17 09:07",
                "utc": "2018-04-17 01:07"
            }
        }
    ]
}