产品介绍

本天气服务系统通过定时访问第三方天气服务商的服务，将得到的指定城市的天气数据存入本地，并向外提供了可获取天气数据的HTTP接口，供各产品线业务系统调用。

1 产品功能与服务

1.1 数据来源

本天气服务中所有天气相关数据来源于服务提供商——心知天气（https://www.seniverse.com/）。

1.2 产品更新简史

2017年初，作为一个定制项目被创建，只提供了4个HTTP服务接口，支持不到100个城市的日天气数据查询；
2018年下旬，健全了项目的说明文档，接口文档，并对项目的定时任务逻辑进行了简单重构；
2019年初至2020年初，HTTP服务接口数量增加至18个，支持约300个城市小时天气数据查询和日数据统计查询，约1000个城市地区的日天气数据查询，并增加了灾害预警数据查询、月级别统计数据的计算；
2020年5月-8月，对整个系统进行了代码重构，重新设计了表结构及存储方式，对天气源数据获取的定时任务进行了优化，升级了第三方城市编码与数据字典城市编码的匹配算法，HTTP服务接口数量增加至25个，支持约1200个城市的小时天气数据查询和日天气数据统计查询，支持3000多个城市区域的日天气数据查询，支持日出日落数据数据查询，支持天气气象图标下载；

2 服务及数据支持说明

2.1 数据类型说明

按时间划分，支持以下类型数据

24小时预报

温度、相对湿度、能见度、气象文字、气象代码、风向、风速

14日天气预报

日最高/低温、相对湿度、白天气象文字/代码、夜晚气象文字/代码、风向文字、风向角、风速、风力等级、降水量

小时级别历史数据

注：最早支持到2017年1月1日。支持数据类型如下：温度、相对湿度、气象文字、气压、能见度、风向文字、风速、风向角风速、风力等级、（2020.7.1之前不支持以下类型）体感温度、空气质量、云量、pm25、pm10、so2、no2、co、o3

日历史数据

注：最早支持到2017年1月1日。支持数据类型如下：日最高温、日最低温、相对湿度、白日气象文字、夜晚气象文字、风向文字、风速、风向角风速、风力等级、（2020.7.1之前不支持以下类型）白天夜晚\气象代码、降雨量

按其他维度划分

统计数据

支持以下数据类型[温度, 相对湿度, 风速, 气压, 能见度]的日最大/小值，日均值查询

其他功能服务数据

支持以下预警类型的预警信息查询，预警类型：[台风, 暴雨, 暴雪, 寒潮, 大风, 沙尘暴, 高温, 干旱, 雷电, 冰雹, 霜冻, 大雾, 道路结冰, 雷雨大风]；
支持基于经纬度坐标（或数据字典城市编码）的日出日落数据查询；
支持天气现象（即阴晴雨雪...）图标下载。

2.2 数据单位说明

本天气服务HTTP接口返回数据指标的默认单位说明如下：

温度（体感温度），c，摄氏度
相对湿度，数值在0~100之间，是百分比数值
气压，mbar，百帕
能见度，km，千米
风向角度，数值在0~360，0为正北，90为正东，180为正南
风速，km/h，千米每小时
风力等级，数值>=0，无单位，数值越大风力越大
降水量，mm，毫米
aqi，数值，无单位
pm25，1小时平均值。单位：μg/m³
pm10，1小时平均值。单位：μg/m³
so2，1小时平均值。单位：μg/m³
no2，1小时平均值。单位：μg/m³
co，1小时平均值。单位：mg/m³
o3，1小时平均值。单位：mg/m³

2.3 枚举字典值说明

空气质量类别

["优"、"良"、"轻度污染"、"中度污染"、"重度污染"、"严重污染"]

天气现象编码与文字描述

{
    "0": "晴",
    "1": "晴",
    "2": "晴",
    "3": "晴",
    "4": "多云",
    "5": "晴间多云",
    "6": "晴间多云",
    "7": "大部多云",
    "8": "大部多云",
    "9": "阴",
    "10": "阵雨",
    "11": "雷阵雨",
    "12": "雷阵雨伴有冰雹",
    "13": "小雨",
    "14": "中雨",
    "15": "大雨",
    "16": "暴雨",
    "17": "大暴雨",
    "18": "特大暴雨",
    "19": "冻雨",
    "20": "雨夹雪",
    "21": "阵雪",
    "22": "小雪",
    "23": "中雪",
    "24": "大雪",
    "25": "暴雪",
    "26": "浮尘",
    "27": "扬沙",
    "28": "沙尘暴",
    "29": "强沙尘暴",
    "30": "雾",
    "31": "霾",
    "32": "风",
    "33": "大风",
    "34": "飓风",
    "35": "热带风暴",
    "36": "龙卷风",
    "37": "冷",
    "38": "热",
    "99": "未知"
}

灾害预警类型

["台风", "暴雨", "暴雪", "寒潮", "大风", "沙尘暴", "高温", "干旱", "雷电", "冰雹", "霜冻", "大雾", "道路结冰", "雷雨大风"]

灾害级别

["白色", "蓝色", "黄色", "橙色", "红色"]

2.4 支持城市

天气实况数据，日历史天气数据，预报数据和灾害预警数据支持3000+个城市地区（几乎涵盖全国所有地区）
小时历史数据和统计数据支持约1200个城市地区（涵盖全国所有一、二、三、四、五线城市的市级，部分涵盖区级）

3 服务更新历史

2020年8月15日，对整个底层代码逻辑行了重构，重新设计了表结构及存储方式，优化了定时任务，升级了数据字典城市编码与第三方城市码的匹配算法。新增若干接口，支持约1200个城市的小时天气数据查询和日天气数据统计查询，支持3000多个城市区域的日天气数据查询，支持日出日落数据数据查询，支持天气气象图标下载；
2019年6月，新增若干接口，支持约300个城市小时天气数据查询和日数据统计查询，约1000个城市地区的日天气数据查询，并增加了灾害预警数据查询、月级别统计数据的计算；
2018年10月，健全了项目的说明文档，接口文档，并对项目的定时任务逻辑进行了简单重构；
2017年4月，作为一个定制项目被创建，提供了4个HTTP服务接口，支持约100个城市的日天气数据查询；