persagy-dmp-server-doc/docs/wther/wther_prod.md

天气服务介绍

基本情况

简介

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

数据服务

本服务支持以下气象指标和数据类型的查询

气象指标全集

指标名	英文标识	单位	说明
气温	temperature	c，摄氏度	对应日最高/低温标识：high/low
体感温度	feels_like	c，摄氏度	英文标识2：feelsLike
相对湿度	humidity	数值在0~100之间，是百分比数值
气压	pressure	单位mbar，百帕
能见度	visibility	km，千米
风速	wind_speed	km/h，千米每小时	英文标识2：windSpeed
风力等级	wind_scale	数值，>=0，无单位	英文标识2：windScale
风向文字	wind_direction	无单位	英文标识2：windDirection
风向角度	wind_direction_degree	角度数值，0~360，0为正北，90为正东，180为正南	英文标识2：windDirectionDegree
降水量	rainfall	mm，毫米
首要污染物	primary_pollutant	无单位	英文标识2：primaryPollutant
气象文字描述	text	阴、晴、雨、雪...，无单位	对应白日/夜晚标识：textDay/textNight
气象编码	code	无单位	对应白日/夜晚标识：codeDay/codeNight
云量	clouds	数值，0~100，无单位
pm25	pm25	1小时平均值。单位：μg/m³
pm10	pm10	1小时平均值。单位：μg/m³
so2	so2	1小时平均值。单位：μg/m³
no2	no2	1小时平均值。单位：μg/m³
co	co	1小时平均值。单位：μg/m³
o3	o3	1小时平均值。单位：μg/m³
aqi	aqi	数值，无单位

气象指标枚举值

空气质量类别

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

天气现象编码与文字描述

{
    "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": "未知"
}

灾害预警类型

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

灾害级别

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

数据类型

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

• 实时数据，气象指标：支持全部气象指标；
• 24小时预报，气象指标：温度、相对湿度、能见度、气象文字、气象代码、风向、风速；
• 14日天气预报，气象指标：日最高/低温、相对湿度、白天气象文字/代码、夜晚气象文字/代码、风向文字、风向角、风速、风力等级、降水量；
• 小时级别历史数据，最早支持到2017年1月1日。 气象指标： 温度、相对湿度、气象文字、气压、能见度、风向文字、风速、风向角风速、风力等级、（2020.7.1之前不支持以下类型）体感温度、空气质量、云量、pm25、pm10、so2、no2、co、o3；
• 日历史数据，最早支持到2017年1月1日。 气象指标： 日最高温、日最低温、相对湿度、白日气象文字、夜晚气象文字、风向文字、风速、风向角风速、风力等级、（2020.7.1之前不支持以下类型）白天夜晚\气象代码、降雨量；

按功能划分，还支持以下数据获取：

• 灾害预警，支持气象部门发布的灾害预警数据查询；
• 统计数据，支持以下气象指标 [温度, 相对湿度, 风速, 气压, 能见度] 的日最大/小值，日均值；
• 日出日落时间计算，支持基于经纬度坐标（数据字典项目ID或数据字典城市编码）的日出日落时间计算；
• 天气现象图标，支持天气现象（即阴晴雨雪...）图标下载

数据来源

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

支持城市

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

产品更新记录

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