完善天气服务文档说明

docs/.vuepress/config.js

@@ -96,7 +96,7 @@ module.exports = {
                 {
                     title: '天气服务',
                     collapsable: false,
-                    children: [{ title: '服务介绍', path: '/wther/wther_prod' }, { title: '服务接口', path: '/wther/wther_api' }]
+                    children: [{ title: '服务介绍', path: '/wther/wther_prod' }, { title: '接口2021版', path: '/wther/wther_api_2021' }, { title: '接口2020版', path: '/wther/wther_api_2020' }]
                 }
             ],
         }

docs/wther/index.md

@@ -1,9 +1,21 @@
 ## 天气服务
 
-#### [产品介绍](/wther/wther_prod.md)
+### [服务介绍](/wther/wther_prod.md)
 
-#### [接口文档](/wther/wther_api.md)
+### [接口文档](/wther/wther_api_2021.md)
 
+#### [2021版接口](/wther/wther_api_2021.md)
 
+#### [2020版接口](/wther/wther_api_2020.md)
+
+**说明**
+
+目前天气服务只向外提供了HTTP形式的接口服务。
+
+接口以2020年为时间线分为两个大版本：2020年版，2021年版本。
+
+这两个版本在接口功能及提供的数据上相同，只是接口风格及返回的数据结构略有差异。
+
+凡首次使用天气服务的产品，应使用2021年版本的接口，2020年版的接口将在2021年7月1日始，拒绝所有新的ip请求，且停止接口的维护。
 
 

docs/wther/wther_api.md

@@ -1,450 +0,0 @@
-# 天气服务接口文档
-
-## 统一说明
-
-所有查询指定城市天气数据的接口，都需要在参数中指明是哪一个城市。目前天气服务支持传入以下三个参数（至少有一个），来定位城市。三个参数的key及说明如下：
-
-| 参数key    | 说明                         |  优先级      | 举例     |
-| --------- | ---------------------------- | ---------- | -------- |
-| cityCode  | 合法数据字典城市编码，6位数字字符串 | 最高       | 110101    |
-| projectId | 合法数据字典项目ID，12位字符串    | 高         | Pj1101010001 |
-| cityName  | 城市中文名，字符串              | 低         | 北京        |
-
-
-## 业务接口
-**注意：** 凡是入参涉及到传城市信息的，以下接口说明中均已cityName作为参数，实际接口调用时，可根据"统一说明"，使用cityCode或者projectId代替cityName参数作为入参。
-
-### 实时数据查询
-
-简介：接口返回指定城市的最新天气数据信息，数据分为两大类A和B。A包括以下信息：天气现象文字(晴、多云...)、天气现象编码、温度、体感温度、气压、相对湿度、能见度、风速、风向文字、风向角度、风力等级、云量（范围0~100，天空被云覆盖的百分比）。
-B包括以下信息：空气质量文字(优、良...)、首要污染物、PM2.5、PM10、so2、no2、co、o3。 
-
-Method：POST 
-
-Header参数：Content-Type=application/json 
-
-URL：/EMS_Weather/Spring/MVC/entrance/unifierJson/dataNow 
-
-请求参数： 
-
-```json
-{
-    "cityName":"城市名称，比如：上海",
-    "dataType":"枚举值字符串：weather,只返回A类数据; air,只返回B类数据; all, 返回A和B类数据"
-}
-```
-
-返回结果：
-
-正确JSON示例
-
-```json
-{
-    "result": "success",
-    "message": null,
-    "data": {
-        "code": "天气现象编码，示例：8", 
-        "o3": "43",
-        "visibility": "能见度示例：9.3",
-        "pm10": "50",
-        "wind_direction": "风向文字，示例：北",
-        "pressure": "气压值，示例：1017", 
-        "clouds": "云量，示例：90", 
-        "co": "0.532",
-        "feels_like": "体感温度，示例：17",
-        "quality": "空气质量文字，示例：优",
-        "no2": "45",
-        "pm25": "30",
-        "so2": "7",
-        "last_update": "2021-01-21 15:50:00",
-        "wind_scale": "风力等级，示例：0",
-        "aqi": "50",
-        "primary_pollutant": "首要污染物，示例：pm25，若无则为空串", 
-        "temperature": "17",
-        "humidity": "相对湿度，示例：82", 
-        "wind_direction_degree": "风向角，示例：0", 
-        "wind_speed": "风速，示例：0.72",
-        "text": "天气现象文字，示例：阴"
-    }
-}
-```
-
-错误JSON示例
-
-```json
-{
-    "result": "fail",
-    "message": "错误信息,如果接口发生错误会返回该字段"
-}
-```
-
-### 预报数据查询
-
-简介：获取未来24小时预报数据，或14天日预报数据。此“未来24小时”包含当前小时整点，以及未来的23个小时的23个整点，共24条天气数据。
-
-Method：POST 
-
-Header参数：Content-Type=application/json 
-
-URL：/EMS_Weather/Spring/MVC/entrance/unifierJson/dataPredict 
-
-请求参数： 
-
-```json
-{
-    "cityName":"城市名称，比如：上海",
-    "dataType":"枚举值字符串：hour,小时预报; day,日预报; disaster,灾害预报",
-    "startTime":"开始时间（包含），dataType为disaster时需要该参数，示例：2021-01-18 00:00:00",
-    "endTime":"结束时间（不包含），dataType为disaster时需要该参数，示例：2021-01-21 00:00:00"
-}
-```
-
-返回结果：
-
-正确JSON，小时预报数据示例
-
-```json
-{
-    "result": "success",
-    "message": null,
-    "data": [
-        {
-            "time": "时间，str，示例：2021-01-21 17:00:00",
-            "text": "天气现象文字，str，示例：晴",
-            "code": "天气现象编码，str，示例：0",
-            "temperature": "温度，str，示例4", 
-            "humidity": "相对湿度，str，示例：41",
-            "wind_direction": "风向文字，str，南",
-            "wind_speed": "风速，str，示例：10"
-        },
-        {
-            "time": "2021-01-21 18:00:00",
-            "text": "晴",
-            "code": "1",
-            "temperature": "1",
-            "humidity": "42",
-            "wind_direction": "西南",
-            "wind_speed": "15"
-        },
-        {
-            "time": "2021-01-22 16:00:00",
-            "text": "晴",
-            "code": "0",
-            "temperature": "4",
-            "humidity": "62",
-            "wind_direction": "南",
-            "wind_speed": "10"
-        }
-    ]
-}
-```
-
-正确JSON，日预报数据示例
-
-```json
-{
-    "result": "success",
-    "message": null,
-    "data": [
-        {
-            "date": "2021-01-21",
-            "high": "日最高温，Str，示例：6",
-            "rainfall": "降雨量，str， 示例：0.0",
-            "codeDay": "白日气象编码，示例：0",
-            "windDirectionDegree": "风向角，str，示例：225", 
-            "textDay": "白日气象文字，str，示例：晴",
-            "codeNight": "白日气象编码，str，示例：1",
-            "low": "日最低温，str，示例：-5",
-            "textNight": "夜晚气象文字，str，示例：晴",
-            "humidity": "相对湿度，str，示例：49",
-            "windDirection": "风向文字，str，示例：西南",
-            "windSpeed": "风速,str，示例：8.4",
-            "windScale": "风力等级,str，示例：2"
-        },
-        {
-            "date": "2021-01-28",
-            "maxTemperature": "4",
-            "rainfall": "0.0",
-            "codeDay": "0",
-            "windDirectionDegree": "225",
-            "textDay": "晴",
-            "codeNight": "1",
-            "minTemperature": "-5",
-            "textNight": "晴",
-            "humidity": "44",
-            "windDirection": "西南",
-            "windSpeed": "8.4",
-            "windScale": "2"
-        }
-    ]
-}
-```
-
-正确JSON，日灾害预警示例
-
-注：
-1. 同一种灾害预警如果级别不同，则结果可能返回多条结果数据；
-2. 灾害数据更新频率为15分钟/次；
-3. 所查询的时间跨度最大支持一年。
-
-```json
-{
-    "result": "success",
-    "message": null,
-    "data": [
-        {
-            "insertTime": "2021-01-19 06:16:06",
-            "path": "北京,北京,中国",
-            "level": "黄色",
-            "pubTime": "2021-01-19 06:08:39",
-            "name": "北京",
-            "description": "市气象台2021年1月19日06时00分发布道路结冰黄色预警信号：目前本市大部分地区出现降雪天气，且地面温度较低，预计当前至20日中午将出现道路结冰现象，请注意防范。",
-            "cityId": "WX4FBXXFKE4F",
-            "title": "北京市气象台2021年1月19日06时00分发布道路结冰黄色预警信号",
-            "type": "道路结冰"
-        }
-    ]
-}
-```
-
-错误JSON示例
-
-```json
-{
-    "result": "fail",
-    "message": "错误信息,如果接口发生错误会返回该字段"
-}
-```
-
-### 历史数据查询
-
-简介：获取小时历史数据或日历史数据。
-
-小时历史数据查询提示：
-1. 该接口能够查询到的最新的小时数据会至少比当前时间滞后半小时，例如结束时间为当天10:10，则接口只能查到最新小时数据为9:00的小时数据；若结束时间为当天10:35则能查到的最新小时数据为10:00的数据；
-2. 目前只支持全国约1200个城市区域；
-3. 改历史历史数据最远可追溯至17年，有些城市最远开始于2020年7月；
-4. 接口最大支持查询7天的数据。
-
-日历史数据查询提示：最大支持一年的数据查询。
-
-Method：POST 
-
-Header参数：Content-Type=application/json 
-
-URL：/EMS_Weather/Spring/MVC/entrance/unifierJson/dataHistory 
-
-请求参数： 
-
-```json
-{
-    "cityName":"城市名称，比如：上海",
-    "dataType":"枚举值字符串：hour,小时数据; day,日数据",
-    "startTime":"开始时间（包含），str，示例：2021-01-01 00:00:00",
-    "endTime":"结束时间（不包含），str，示例：2021-01-03 00:00:00"
-}
-```
-
-返回结果：
-
-正确JSON，小时历史数据示例
-
-```json
-{
-    "result": "success",
-    "message": null,
-    "data": [
-        {
-            "code": "天气现象编码，str，示例：1",
-            "visibility": "能见度，str，示例：15.3",
-            "o3": "7",
-            "pm10": "60",
-            "pressure": "气压值，str，示例：1023",
-            "clouds": "云量，str，示例：0",
-            "co": "0.608",
-            "quality": "空气质量文字，str，示例：良", 
-            "feelsLike": "体感温度，str，示例：-6",
-            "windDirectionDegree": "风向角，str，示例：0",
-            "no2": "52",
-            "hourTime": "2021-01-01 00:00:00",
-            "pm25": "22",
-            "so2": "3",
-            "temperature": "温度，str，示例：-7",
-            "aqi": "气象指标指数，str，示例：55",
-            "humidity": "相对湿度，str，示例：37",
-            "primaryPollutant": "首要污染物，str，示例：PM10",
-            "text": "天气现象文字，str，示例：晴",
-            "windDirection": "风向，str，示例：北",
-            "windSpeed": "风速，str，示例：2.16",
-            "windScale": "风力等级，str，示例：1"
-        }
-    ]
-}
-```
-
-正确JSON，日历史数据示例
-
-```json
-{
-    "result": "success",
-    "message": null,
-    "data": [
-        {
-            "rainfall": "降雨量，str，示例：0.0",
-            "codeDay": "白日气象编码，str，示例：0",
-            "dayTime": "2021-01-01 00:00:00",
-            "windDirectionDegree": "风向角，str，示例：225",
-            "high": "日最高温，str，示例：1",
-            "textDay": "白日天气现象文字，str，示例：晴",
-            "codeNight": "夜晚气象编码，str，示例：1",
-            "low": "日最低温，str，示例：-11",
-            "textNight": "晚间天气现象文字，str，示例：晴",
-            "humidity": "相对湿度，str，示例：24",
-            "windDirection": "降雨量，str，示例：西南",
-            "windSpeed": "风速，str，示例：8.4",
-            "windScale": "风力等级，str，示例：2"
-        }
-    ]
-}
-```
-
-错误JSON示例
-
-```json
-{
-    "result": "fail",
-    "message": "错误信息,如果接口发生错误会返回该字段"
-}
-```
-
-### 统计数据查询
-
-简介：获取以下气象指标【温度、相对湿度、风速、气压、能见度】的日最大/小值和日均值数据。
-
-提示：
-1. 有小时天气历史数据的城市才有日统计数据记录；
-2. 数据在每日0-1时更新；
-3. 接口最大支持一年的数据查询；
-
-Method：POST 
-
-Header参数：Content-Type=application/json 
-
-URL：/EMS_Weather/Spring/MVC/entrance/unifierJson/dataStatistic 
-
-请求参数： 
-
-```json
-{
-    "cityName":"城市名称，比如：上海",
-    "dataSize":"枚举值字符串：max,返回最大最小值; avg,返回均值，all,返回最值和均值",
-    "startTime":"开始时间（包含），str，示例：2021-01-01 00:00:00",
-    "endTime":"结束时间（不包含），str，示例：2021-01-03 00:00:00"
-}
-```
-
-返回结果：
-
-正确JSON示例
-
-```json
-{
-    "result": "success",
-    "message": null,
-    "data": [
-        {
-            "maxVisibility": 27.0,
-            "avgPressure": 1021.5,
-            "maxTemp": 1.0, 
-            "avgHumidity": 37.0,
-            "avgTemp": -5.4, 
-            "minHumidity": 17.0,
-            "dayTime": "2021-01-01 00:00:00",
-            "minTemp": -11.0,
-            "maxWindSpeed": 8.0,
-            "avgWindSpeed": 4.0,
-            "minVisibility": 11.0,
-            "avgVisibility": 17.0,
-            "minPressure": 1020.0,
-            "maxPressure": 1024.0,
-            "minWindSpeed": 1.0,
-            "maxHumidity": 59.0
-        }
-    ]
-}
-```
-
-错误JSON示例
-
-```json
-{
-    "result": "fail",
-    "message": "错误信息,如果接口发生错误会返回该字段"
-}
-```
-
-### 日出日落时间计算
-
-简介：根据坐标或者数据字典城市编码或者包含数据字典城市编码的项目数据字典ID计算日出日落时间。
-
-提示：入参支持数据字典城市名称，数据字典城市编码，符合数据字典命名规范的项目ID，经纬度值，四项参数不能全部为空，使用优先级：经纬度值> 数据字典城市编码 > 项目ID > 城市名称。该接口支持最长一年的数据计算。
-
-Method：POST 
-
-Header参数：Content-Type=application/json 
-
-URL：/EMS_Weather/Spring/MVC/entrance/unifierJson/sunRiseAndSetCompute 
-
-请求参数： 
-
-```json
-{
-    "cityName":"城市名称，比如：上海",
-    "longitude":116.4,
-    "latitude":39.9,
-    "startDay":"开始日（含），str，示例：2021-02-14",
-    "endDay":"结束日（不含），str，示例：2021-02-15"
-}
-```
-
-返回结果：
-
-正确JSON示例
-
-```json
-{
-    "result": "success",
-    "message": null,
-    "data": [
-        {
-            "day": "日时间yyyy-MM-dd，str，示例：2021-02-14",
-            "sunSet": "日落时间HH:mm:ss，str，示例：17:50:00",
-            "sunRise": "日出时间HH:mm:ss，str，示例：07:06:00"
-        }
-    ]
-}
-```
-
-错误JSON示例
-
-```json
-{
-    "result": "fail",
-    "message": "错误信息,如果接口发生错误会返回该字段"
-}
-```
-
-### 天气现象图标下载
-
-简介：获取天气现象编码对应的图标图片数据。
-
-Method：GET 
-
-URL：/EMS_Weather/Spring/MVC/entrance/download/icon/weatherCode-theme-size 
-
-URL说明：
-1. 以HTTP-GET访问接口，接口参数在URL最后面；
-2. 参数格式为weatherCode-theme-size。其中weatherCode为天气现象编码，必需；theme为图片主题，非必需，支持dark、light、classic三种；size为图标大小，非必需，支持big、small两种。
-3. 接口请求示例：/EMS_Weather/Spring/MVC/entrance/download/icon/5-classic-big
-
-返回结果：数据流

docs/wther/wther_api_2020.md

@@ -0,0 +1,774 @@
+# 天气服务接口2020版
+
+**强调**：2020版接口的维护将于2021.7.1日截止。自2021.7.1日始，所有首次访问天气服务2020版接口的ip请求将被拒绝。
+
+## 统一说明
+
+#### POST接口请求方式说明
+
+凡是Method为POST方式的接口，支持两种参数请求方式。
+这两种请求方式的Header参数（Content-Type）值不同。
+
+##### 方式一
+
+该类接口以接口以http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/**unifier**开头 
+
+HTTP请求的Header需设置参数如下：
+
+```
+Content-Type=application/x-www-form-urlencoded
+```
+
+body体传参为字符串，格式为jsonString={"key":"value"}，其中jsonString为固定字符，后面为Json格式字符串参数。
+
+##### 方式二
+
+该类接口以接口以http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/**unifierJson**开头 
+
+HTTP请求的Header需设置参数如下：
+
+```
+Content-Type=application/json
+```
+
+body体传参为Json格式字符串，例如：{"key":"value"}。
+
+#### 统一参数说明
+
+**所有查询指定城市天气数据的接口，都需要在参数中指明是哪一个城市。**
+目前天气服务支持传入cityCode、projectId、cityName三个参数(之一)来定位城市（说明见下表）。
+
+
+| 参数key    | 说明                         |  优先级      | 举例     |
+| --------- | ---------------------------- | ---------- | -------- |
+| cityCode  | 合法数据字典城市编码，6位数字字符串 | 最高       | 110101    |
+| projectId | 合法数据字典项目ID，12位字符串    | 高         | Pj1101010001 |
+| cityName  | 城市中文名，字符串              | 低         | 北京        |
+
+
+## 接口说明
+**注意：** 
+
+1. 凡是入参涉及到传城市信息的，以下接口说明中均已cityName作为参数，实际接口调用时，可根据*统一参数说明*，使用cityCode或者projectId代替cityName参数作为入参。
+2. 凡未特别注释，示例中的接口示入参均为必需项。
+
+### 实时数据查询
+
+简介：接口返回指定城市的最新天气数据信息，数据分为两大类A和B。
+A包括以下信息：天气现象文字(晴、多云...)、天气现象编码、温度、体感温度、气压、相对湿度、能见度、风速、风向文字、风向角度、风力等级、云量（范围0~100，天空被云覆盖的百分比）。
+B包括以下信息：空气质量文字(优、良...)、首要污染物、PM2.5、PM10、so2、no2、co、o3。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/NowWeatherQuery 
+
+请求参数： 
+
+```json
+{
+    "cityName":"城市名称，比如：上海",
+    "dataType":"枚举值字符串：weather,只返回A类数据; air,只返回B类数据; all, 返回A和B类数据"
+}
+```
+
+返回结果：
+
+正确结果JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        {
+            "code": "天气现象编码，示例：8", 
+            "o3": "43",
+            "visibility": "能见度示例：9.3",
+            "pm10": "50",
+            "wind_direction": "风向文字，示例：北",
+            "pressure": "气压值，示例：1017", 
+            "clouds": "云量，示例：90", 
+            "co": "0.532",
+            "feels_like": "体感温度，示例：17",
+            "quality": "空气质量文字，示例：优",
+            "no2": "45",
+            "pm25": "30",
+            "so2": "7",
+            "last_update": "2021-01-21 15:50:00",
+            "wind_scale": "风力等级，示例：0",
+            "aqi": "50",
+            "primary_pollutant": "首要污染物，示例：pm25，若无则为空串", 
+            "temperature": "17",
+            "humidity": "相对湿度，示例：82", 
+            "wind_direction_degree": "风向角，示例：0", 
+            "wind_speed": "风速，示例：0.72",
+            "text": "天气现象文字，示例：阴"
+        }
+    ]
+}
+```
+
+错误结果JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 24小时预报数据查询
+
+简介：获取未来24小时的小时天气信息。此“未来24小时”包含当前小时整点，以及未来的23个小时的23个整点，共24条天气数据。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/Hour24Forecast 
+
+请求参数： 
+
+```json
+{
+    "cityName":"城市名称，比如：上海"
+}
+```
+
+返回结果：
+
+正确结果JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        {
+            "location": {
+                "id": "WX4FBXXFKE4F",
+                "name": "北京",
+                "country": "CN",
+                "path": "北京,北京,中国",
+                "timezone": "Asia/Shanghai",
+                "timezone_offset": "+08:00"
+            },
+            "hourly": [
+                {
+                    "time": "时间，str，示例：2021-01-21 17:00:00",
+                    "text": "天气现象文字，str，示例：晴",
+                    "code": "天气现象编码，str，示例：0",
+                    "temperature": "温度，str，示例4", 
+                    "humidity": "相对湿度，str，示例：41",
+                    "wind_direction": "风向文字，str，南",
+                    "wind_speed": "风速，str，示例：10"
+                },
+                {
+                    "time": "2021-01-21 18:00:00",
+                    "text": "晴",
+                    "code": "1",
+                    "temperature": "1",
+                    "humidity": "42",
+                    "wind_direction": "西南",
+                    "wind_speed": "15"
+                },
+                {
+                    "time": "2021-01-22 16:00:00",
+                    "text": "晴",
+                    "code": "0",
+                    "temperature": "4",
+                    "humidity": "62",
+                    "wind_direction": "南",
+                    "wind_speed": "10"
+                }
+            ]
+        }
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 14天日预报
+
+简介：获取今天及未来共14天的天气预报信息。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/DayForecast 
+
+请求参数： 
+
+```json
+{
+    "cityName":"城市名称，比如：上海",
+    "startDay":"非必需参数，未来14天中，某一段时间的开始日（包含），示例：2021-01-21",
+    "endDay":"非必需参数，未来14天中，某一段时间的结束日（不包含）2021-01-29，示例：2021-01-21"
+}
+```
+
+结果示例
+
+正确结果JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        {
+            "date": "2021-01-21",
+            "maxTemperature": "日最高温，Str，示例：6",
+            "rainfall": "降雨量，str， 示例：0.0",
+            "codeDay": "白日气象编码，示例：0",
+            "windDirectionDegree": "风向角，str，示例：225", 
+            "textDay": "白日气象文字，str，示例：晴",
+            "codeNight": "白日气象编码，str，示例：1",
+            "minTemperature": "日最低温，str，示例：-5",
+            "textNight": "夜晚气象文字，str，示例：晴",
+            "humidity": "相对湿度，str，示例：49",
+            "windDirection": "风向文字，str，示例：西南",
+            "windSpeed": "风速,str，示例：8.4",
+            "windScale": "风力等级,str，示例：2"
+        },
+        {
+            "date": "2021-01-28",
+            "maxTemperature": "4",
+            "rainfall": "0.0",
+            "codeDay": "0",
+            "windDirectionDegree": "225",
+            "textDay": "晴",
+            "codeNight": "1",
+            "minTemperature": "-5",
+            "textNight": "晴",
+            "humidity": "44",
+            "windDirection": "西南",
+            "windSpeed": "8.4",
+            "windScale": "2"
+        }
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 小时级历史数据
+简介：根据城市信息及开始时间、结束时间，获取城市小时天气历史数据。
+
+注意：
+1. 该接口能够查询到的最新的小时数据会至少比当前时间滞后半小时，例如结束时间为当天10:10，则接口只能查到最新小时数据为9:00的小时数据；若结束时间为当天10:35则能查到的最新小时数据为10:00的数据；
+2. 目前只支持全国约1200个城市区域；
+3. 改历史历史数据最远可追溯至17年，有些城市最远开始于2020年7月；
+4. 接口最大支持查询7天的数据。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/HourHistoryData 
+
+请求参数： 
+
+```json
+{
+    "cityName":"城市名称，比如：上海",
+    "minResponse":"是否只返回部分指标数据，boolean类型",
+    "startTime":"开始时间（包含），str，示例：2021-01-01 00:00:00",
+    "endTime":"结束时间（不包含），str，示例：2021-01-03 00:00:00"
+}
+```
+
+注：参数minResponse，默认值true,表示返回所有气象指标数据；false，只返回温度、相对湿度、风速、空气质量文字、天气现象文字六项数据
+
+返回结果：
+
+正确JSON，小时历史数据示例
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        {
+            "code": "天气现象编码，str，示例：1",
+            "visibility": "能见度，str，示例：15.3",
+            "o3": "7",
+            "pm10": "60",
+            "pressure": "气压值，str，示例：1023",
+            "clouds": "云量，str，示例：0",
+            "co": "0.608",
+            "quality": "空气质量文字，str，示例：良", 
+            "feelsLike": "体感温度，str，示例：-6",
+            "windDirectionDegree": "风向角，str，示例：0",
+            "no2": "52",
+            "hourTime": "2021-01-01 00:00:00",
+            "pm25": "22",
+            "so2": "3",
+            "temperature": "温度，str，示例：-7",
+            "aqi": "气象指标指数，str，示例：55",
+            "humidity": "相对湿度，str，示例：37",
+            "primaryPollutant": "首要污染物，str，示例：PM10",
+            "text": "天气现象文字，str，示例：晴",
+            "windDirection": "风向，str，示例：北",
+            "windSpeed": "风速，str，示例：2.16",
+            "windScale": "风力等级，str，示例：1"
+        }
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 日级历史数据
+
+简介：根据城市信息及开始时间、结束时间，获取城市日历史数据。该接口最大支持一年的数据查询。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/dataHistory 
+
+请求参数： 
+
+```json
+{
+    "cityName":"城市名称，比如：上海",
+    "startTime":"开始时间（包含），str，示例：2021-01-01 00:00:00",
+    "endTime":"结束时间（不包含），str，示例：2021-01-03 00:00:00"
+}
+```
+
+返回结果：
+
+正确JSON
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        {
+            "rainfall": "降雨量，str，示例：0.0",
+            "codeDay": "白日气象编码，str，示例：0",
+            "dayTime": "2021-01-01 00:00:00",
+            "windDirectionDegree": "风向角，str，示例：225",
+            "high": "日最高温，str，示例：1",
+            "textDay": "白日天气现象文字，str，示例：晴",
+            "codeNight": "夜晚气象编码，str，示例：1",
+            "low": "日最低温，str，示例：-11",
+            "textNight": "晚间天气现象文字，str，示例：晴",
+            "humidity": "相对湿度，str，示例：24",
+            "windDirection": "降雨量，str，示例：西南",
+            "windSpeed": "风速，str，示例：8.4",
+            "windScale": "风力等级，str，示例：2"
+        }
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 日统计数据
+
+简介：获取以下气象指标【温度、相对湿度、风速、气压、能见度】的日最大/小值和日均值数据。
+
+注意：有小时天气历史数据的城市才有日统计数据记录，该记录数据在每日凌晨将昨日小时气象数据统计得出；该接口最大支持一年的数据查询。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/DayStaticData 
+
+请求参数： 
+
+```json
+{
+    "cityName":"城市名称，比如：上海",
+    "startTime":"开始时间（包含），str，示例：2021-01-01 00:00:00",
+    "endTime":"结束时间（不包含），str，示例：2021-01-03 00:00:00",
+    "dataType":"返回数据类型，字符串枚举值，示例：All"
+}
+```
+
+注：参数dataType三个可选枚举值，默认为Max，表示获取最大最小值；Avg，表示获取平均值；All，表示获取最大最小值和平均值
+
+返回结果：
+
+正确JSON
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        {
+            "maxVisibility": 27.0,
+            "avgPressure": 1021.5,
+            "maxTemp": 1.0, 
+            "avgHumidity": 37.0,
+            "avgTemp": -5.4, 
+            "minHumidity": 17.0,
+            "dayTime": "2021-01-01 00:00:00",
+            "minTemp": -11.0,
+            "maxWindSpeed": 8.0,
+            "avgWindSpeed": 4.0,
+            "minVisibility": 11.0,
+            "avgVisibility": 17.0,
+            "minPressure": 1020.0,
+            "maxPressure": 1024.0,
+            "minWindSpeed": 1.0,
+            "maxHumidity": 59.0
+        }
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 灾害预警
+
+简介：取指定城市的指定时间区间的灾害预警信息。
+
+注：
+
+1.同一种灾害预警如果级别不同，则结果可能返回多条结果数据；
+2.灾害数据更新频率为15分钟/次；
+3.所查询的时间跨度最大支持一年。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/DisasterWarningQuery 
+
+请求参数： 
+
+```json
+{
+    "cityName":"城市名称，比如：上海",
+    "startTime":"开始时间（包含），str，示例：2021-01-01 00:00:00",
+    "endTime":"结束时间（不包含），str，示例：2021-01-03 00:00:00",
+    "type":"非必需，灾害类型枚举，str,示例：道路结冰",
+    "level":"非必需，预警级别枚举值，str，示例：黄色"
+}
+```
+
+正确JSON，日灾害预警示例
+
+注：
+1. 同一种灾害预警如果级别不同，则结果可能返回多条结果数据；
+2. 灾害数据更新频率为15分钟/次；
+3. 所查询的时间跨度最大支持一年。
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        {
+            "insertTime": "2021-01-19 06:16:06",
+            "path": "北京,北京,中国",
+            "level": "黄色",
+            "pubTime": "2021-01-19 06:08:39",
+            "name": "北京",
+            "description": "市气象台2021年1月19日06时00分发布道路结冰黄色预警信号：预计当前至20日中午将出现道路结冰现象，请注意防范。",
+            "cityId": "WX4FBXXFKE4F",
+            "title": "北京市气象台2021年1月19日06时00分发布道路结冰黄色预警信号",
+            "type": "道路结冰"
+        }
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+
+### 日出日落时间计算
+
+简介：根据坐标或者数据字典城市编码或者包含数据字典城市编码的项目数据字典ID计算日出日落时间。
+
+提示：入参支持数据字典城市名称，数据字典城市编码，符合数据字典命名规范的项目ID，经纬度值，四项参数不能全部为空，使用优先级：经纬度值> 数据字典城市编码 > 项目ID > 城市名称。该接口支持最长一年的数据计算。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/SunRiseAndSet 
+
+请求参数： 
+
+```json
+{
+    "cityName":"城市名称，比如：上海",
+    "longitude":116.4,
+    "latitude":39.9,
+    "startDay":"开始日（含），str，示例：2021-02-14",
+    "endDay":"结束日（不含），str，示例：2021-02-15"
+}
+```
+
+返回结果：
+
+正确JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        {
+            "sunSet": "日落时间，示例：2021-02-14 17:50:00",
+            "sunRise": "日出时间，示例：2021-02-14 07:06:00"
+        }
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 字典数据-天气现象编码与文字
+
+简介：取天气现象编码及文字描述信息。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/DicWeatherCodeName 
+
+请求参数： 
+
+```json
+{}
+```
+
+返回结果：
+
+正确JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        {
+            "0": "晴",
+            "1": "晴",
+            "2": "晴",
+            "3": "晴",
+            "4": "多云",
+            "5": "晴间多云",
+            "6": "晴间多云",
+            "7": "大部多云",
+            "8": "大部多云"
+        }
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 字典数据-灾害预警类型
+
+简介：取天气现象编码及文字描述信息。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/DicDisasterType 
+
+请求参数： 
+
+```json
+{}
+```
+
+返回结果：
+
+正确JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        "台风",
+        "暴雨",
+        "暴雪",
+        "寒潮",
+        "大风",
+        "沙尘暴",
+        "高温",
+        "干旱",
+        "雷电",
+        "冰雹",
+        "霜冻",
+        "大雾",
+        "道路结冰",
+        "雷雨大风"
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 字典数据-灾害预警级别
+
+简介：取天气现象编码及文字描述信息。
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/unifierJson/DicDisasterLevel 
+
+请求参数： 
+
+```json
+{}
+```
+
+返回结果：
+
+正确JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "success",
+    "reason": null,
+    "content": [
+        "白色",
+        "蓝色",
+        "黄色",
+        "橙色",
+        "红色"
+    ]
+}
+```
+
+错误JSON示例
+
+```json
+{
+    "version": "1.0",
+    "result": "failure",
+    "reason": "错误信息",
+    "content": []
+}
+```
+
+### 天气现象图标下载
+
+简介：获取天气现象编码对应的图标图片数据。
+
+Method：GET 
+
+URL：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/download/icon/weatherCode-theme-size 
+
+URL说明：
+1. 以HTTP-GET访问接口，接口参数在URL最后面；
+2. 参数格式为weatherCode-theme-size。其中weatherCode为天气现象编码，必需；theme为图片主题，非必需，支持dark、light、classic三种；size为图标大小，非必需，支持big、small两种。
+3. 接口请求示例：http://127.0.0.1:8888/EMS_Weather/Spring/MVC/entrance/download/icon/5-classic-big
+
+返回结果：数据流

docs/wther/wther_api_2021.md

@@ -0,0 +1,146 @@
+# 天气服务接口2021版
+
+## 统一说明
+
+#### 统一参数说明
+
+**所有查询指定城市天气数据的接口，都需要在参数中指明是哪一个城市。**
+目前天气服务支持传入cityCode、projectId、cityName三个参数(之一)来定位城市（说明见下表）。
+
+
+| 参数key    | 说明                         |  优先级      | 举例     |
+| --------- | ---------------------------- | ---------- | -------- |
+| cityCode  | 合法数据字典城市编码，6位数字字符串 | 最高       | 110101    |
+| projectId | 合法数据字典项目ID，12位字符串    | 高         | Pj1101010001 |
+| cityName  | 城市中文名，字符串              | 低         | 北京        |
+
+
+## 接口说明
+
+>
+> **注意：** 如未特殊说明，城市信息、dataType、time为必须传值。
+> 以下接口示例中，城市信息参数使用cityName作为参数，实际接口调用时，可根据*统一参数说明*，使用cityCode或者projectId代替cityName参数作为入参。
+> dataType的值为[服务介绍](/wther/wther_prod.md)中**数据类型**的类型码。
+> time参数为区间值，格式为时间戳。
+>
+> 接口所有入参及返回结果，时间字段的值均为时间戳格式，其余字段值为字符串格式。
+>
+> **除特殊说明外，所有的查询接口入参规则，请参照[通用查询](/utils/query.md)，本文档的查询入参只包含通用查询的criteria部分，查询条件目前只支持：等于，和基于time参数的比较大小**
+>
+
+
+### 气象数据通用查询接口
+
+简介：支持[服务介绍](/wther/wther_prod.md)中所规定**数据类型**的相关气象指标数据查询
+
+Method：POST 
+
+Header参数：Content-Type=application/json 
+
+URL：http://127.0.0.1:8888/persagy-weather/Spring/MVC/unifier/common/dataQuery 
+
+请求参数： 
+
+```json5
+{
+    "cityName":"上海", // 该参数可用cityCode或projectId代替
+    "dataType":"present",
+    "time": {
+        "$gte": 1602434380000,
+        "$lt": 1602474380000
+    }
+}
+```
+
+返回结果：
+
+错误JSON示例
+
+```json
+{
+    "result": "fail",
+    "message": "错误信息"
+}
+```
+
+dataType=present，正确结果JSON示例
+
+```json5
+{
+    "result": "success",
+    "message": null,
+    "data": {
+        "temperature": "17",
+        "code": "天气现象编码，示例：8", 
+        "o3": "43",
+        "visibility": "能见度示例：9.3",
+        "...": "..." // 其余返回项见服务介绍文档-支持数据
+    }
+}
+```
+
+dataType=predictHour，正确结果JSON示例
+
+```json5
+{
+    "result": "success",
+    "message": null,
+    "data": [
+        {
+            "time": 1602434380000,
+            "text": "天气现象文字，str，示例：晴",
+            "code": "天气现象编码，str，示例：0",
+            "temperature": "温度，str，示例4", 
+            "...": "..." // 其余返回项见服务介绍文档-支持数据
+        }
+    ]
+}
+```
+
+dataType=disaster，正确结果JSON示例
+
+```json5
+{
+    "result": "success",
+    "message": null,
+    "data": [
+        {
+            "level": "黄色",
+            "pubTime": "2021-01-19 06:08:39",
+            "description": "市气象台2021年1月19日06时00分发布道路结冰黄色预警信号：预计当前至20日中午将出现道路结冰现象，请注意防范。",
+            "title": "北京市气象台2021年1月19日06时00分发布道路结冰黄色预警信号",
+            "type": "道路结冰"
+        }
+    ]
+}
+```
+
+所有dataType（类型码）对应结果说明
+
+| 类型名        | 类型码         | 入参说明       | 结果说明       |
+| ------------ | ------------ | ------------ | ------------ |
+| 实时数据     | present       | time参数无效   | 见上文示例      |
+| 小时预报数据   | predictHour  |              | 见上文示例      |
+| 日预报数据    | predictDay    |              | 格式同predictHour |
+| 小时历史数据   | historyHour  | time跨度<=7天  | 格式同predictHour |
+| 日历史数据    | historyDay    | time跨度<366天  | 格式同predictHour |
+| 日统计数据    | statisticDay  | time跨度<366天  | 格式同predictHour |
+| 灾害预警数据    | disaster    | time跨度<366天  | 见上文示例      |
+| 日出日落数据    | sunRiseSet  | time跨度<366天  | 格式同predictHour |
+
+说明：若dataType=sunRiseSet，城市信息可以使用经纬度坐标参数代替（参数：longitude、latitude，值为小数数值）
+
+### 天气现象图标下载
+
+简介：获取天气现象编码对应的图标图片数据。
+
+Method：GET 
+
+URL：http://127.0.0.1:8888/persagy-weather/Spring/MVC/entrance/download/icon/weatherCode-theme-size 
+
+URL说明：
+1. 以HTTP-GET访问接口，接口参数在URL最后面；
+2. 参数格式为weatherCode-theme-size。其中weatherCode为天气现象编码，必需；theme为图片主题，非必需，支持dark、light、classic三种；size为图标大小，非必需，支持big、small两种。
+3. 接口请求示例：http://127.0.0.1:8888/persagy-weather/Spring/MVC/entrance/download/icon/5-classic-big
+
+返回结果：数据流

docs/wther/wther_prod.md

@@ -1,50 +1,90 @@
 # 天气服务介绍
 
-## 基本情况
-
-### 简介
+## 简介
 
 本天气服务通过定时访问第三方天气服务商的服务，将得到的指定城市的天气数据存入本地，并向外提供了可获取天气数据的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         | 数值，无单位                   |                                         |
-
-#### 气象指标枚举值
-
-##### 空气质量类别
+| 指标名        | 英文标识       | 单位及其他说明              |
+| ------------ | ------------ | ------------------------- |
+| 气温实时值     | temperature  | c，摄氏度                  |
+| 体感温度       | feelsLike   | c，摄氏度                   | 
+| 日最高温度     | temperatureHigh   | c，摄氏度              | 
+| 日最低温度     | temperatureLow   | c，摄氏度              | 
+| 统计温度最大值     | temperatureMax   | c，摄氏度              | 
+| 统计温度最小值     | temperatureMin   | c，摄氏度              | 
+| 统计温度均值     | temperatureAvg   | c，摄氏度              | 
+| 相对湿度       | humidity     | 数值范围0~100，是百分比值 |
+| 统计相对湿度最大值     | humidityMax     | 数值范围0~100，是百分比值 |
+| 统计相对湿度最小值     | humidityMin     | 数值范围0~100，是百分比值 | 
+| 统计相对湿度均值       | humidityAvg     | 数值范围0~100，是百分比值 |
+| 气压          | pressure     | 单位mbar，百帕              |
+| 统计气压最大值   | pressureMax     | 单位mbar，百帕              |
+| 统计气压最小值   | pressureMin     | 单位mbar，百帕              |
+| 统计气压均值     | pressureAvg     | 单位mbar，百帕              |
+| 能见度        | visibility   | km，千米                    |
+| 统计能见度最大值     | visibilityMax   | km，千米                    |
+| 统计能见度最小值     | visibilityMin   | km，千米                    |
+| 统计能见度均值       | visibilityAvg   | km，千米                    |
+| 风速          | windSpeed   | km/h，千米每小时             |
+| 统计风速最大值       | windSpeedMax   | km/h，千米每小时             |
+| 统计风速最小值       | windSpeedMin   | km/h，千米每小时             |
+| 统计风速均值         | windSpeedAvg   | km/h，千米每小时             |
+| 风力等级       | windScale   | 数值，>=0，无单位            |
+| 风向文字       | windDirection   | 无单位，描述信息，如：西南          | 
+| 风向角度       | windDirectionDegree   | 角度数值，0~360，0为正北，90为正东，180为正南 |
+| 降水量         | rainfall    | mm，毫米                     | 
+| 首要污染物      | primaryPollutant   | 无单位，字符描述            | 
+| 气象文字描述    | text      | 阴、晴、雨、雪...，无单位        | 
+| 白日气象文字描述    | textDay      | 阴、晴、雨、雪...，无单位        | 
+| 夜晚气象文字描述    | textNight      | 阴、晴、雨、雪...，无单位        | 
+| 气象编码       | code      | 无单位                        | 
+| 白日气象编码    | codeDay      | 无单位                  | 
+| 夜晚气象编码    | codeNight      | 无单位                  | 
+| 空气质量文字    | quality      | 优、良、轻度污染...，无单位     | 
+| 云量           | 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         | 数值，无单位                   |
+
+
+#### 日出日落信息
+
+| 指标名        | 英文标识       | 单位及其他说明              |
+| ------------ | ------------ | ------------------------- |
+| 日出时间          | sunRise        | 时间戳                   |
+| 日落时间          | sunSet         | 时间戳                   | 
+
+
+#### 灾害预警信息
+
+| 指标名        | 英文标识       | 单位及其他说明              |
+| ------------ | ------------ | ------------------------- |
+| 灾害预警级别    | level  |                   |
+| 预警发布时间    | pubTime   |  时间戳           | 
+| 预警描述信息    | description   |              | 
+| 灾害预警标题   | title   |             | 
+| 灾害预警类型   | type   |             | 
+
+
+## 枚举值
+
+#### 空气质量类别
 
 ```json
 ["优", "良", "轻度污染", "中度污染", "重度污染", "严重污染"]
 ```
 
-##### 天气现象编码与文字描述
+#### 气象编码与气象文字描述
 
 ```json
 {
@@ -91,44 +131,87 @@
 }
 ```
 
-##### 灾害预警类型
+#### 灾害预警类型
 
 ```json
 ["台风", "暴雨", "暴雪", "寒潮", "大风", "沙尘暴", "高温", "干旱", "雷电", "冰雹", "霜冻", "大雾", "道路结冰", "雷雨大风"]
 ```
 
-##### 灾害级别
+#### 灾害级别
 
 ```json
 ["白色", "蓝色", "黄色", "橙色", "红色"]
 ```
 
 
-#### 数据类型
-按时间划分，支持以下类型数据查询： 
+## 气象数据类型
+按时间和功能划分，支持以下类型数据查询： 
+
+| 类型名        | 类型码       | 
+| ------------ | ------------ | 
+| 实时数据     | present  | 
+| 小时预报数据   | predictHour | 
+| 日预报数据    | predictDay  | 
+| 小时历史数据   | historyHour | 
+| 日历史数据    | historyDay  |
+| 日统计数据    | statisticDay  |
+| 灾害预警数据    | disaster  |
+| 日出日落数据    | sunRiseSet  |
+
+* **实时数据** 
+
+获取某城市当前气象数据信息。支持的气象指标有：气温实时值, 体感温度, 相对湿度, 气压, 能见度, 风速, 风力等级, 风向文字, 风向角度, 首要污染物, 气象文字描述, 气象编码, 空气质量文字, 云量, pm25, pm10, so2, no2, co, o3, aqi。
+
+
+* **小时预报数据** 
+
+可获取包含当前小时及未来23小时的预报数据。支持气象指标：气温实时值, 相对湿度, 风速, 风向文字, 气象文字描述, 气象编码。
+
+
+* **日预报数据** 
+
+可获取包含当天及未来14日的预报数据。支持气象指标：日最高温度, 日最低温度, 相对湿度, 风速, 风力等级, 风向文字, 风向角度, 降水量, 白日气象文字描述, 夜晚气象文字描述, 白日气象编码, 夜晚气象编码。
+
+
+* **小时历史数据** 
+
+最早可获取到2017年1月1日数据。支持气象指标： 气温实时值, 相对湿度, 气象文字, 气压, 能见度, 风速, 风力等级, 风向文字, 风向角度,（2020.7.1之前不支持以下类型）体感温度, 首要污染物, 气象文字描述, 气象编码, 空气质量文字, 云量, pm25, pm10, so2, no2, co, o3, aqi；
+
+
+* **日历史数据** 
+
+最早可获取到2017年1月1日数据。支持气象指标： 日最高温度, 日最低温度, 相对湿度, 白日气象文字描述, 夜晚气象文字描述, 风速, 风向角, （2020.7.1之前不支持以下类型）风力等级, 风向文字, 白日气象编码, 夜晚气象编码, 降雨量。
+
+
+* **日统计数据** 
+
+凡具有小时历史数据的城市，均有日统计数据。最早可获取到2017年1月1日数据。 支持气象指标： [温度, 相对湿度, 风速, 气压, 能见度] 的日最大值、最小值、均值。
+
+
+* **灾害预警数据** 
+
+支持以下灾害类型的预警信息查询： ["台风", "暴雨", "暴雪", "寒潮", "大风", "沙尘暴", "高温", "干旱", "雷电", "冰雹", "霜冻", "大雾", "道路结冰", "雷雨大风"]
+
+
+* **日出日落数据** 
+
+支持根据经纬度坐标，或者数据字典城市编码，或者包含数据字典城市编码的项目数据字典ID，来计算日出时间和日落时间。
+
 
-* 实时数据，气象指标：支持全部气象指标；
-* 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个城市地区（涵盖全国所有一、二、三、四、五线城市的市级，部分涵盖区级）
+* 小时历史数据和统计数据支持约1200个城市地区（几乎涵盖全国所有一、二、三、四、五线城市的市级，部分涵盖区级）
 
-### 产品更新记录
+## 产品更新记录
 
 * 2020年8月15日，对整个底层代码逻辑行了重构，重新设计了表结构及存储方式，优化了定时任务，升级了数据字典城市编码与第三方城市码的匹配算法。新增若干接口，支持约1200个城市的小时天气数据查询和日天气数据统计查询，支持3000多个城市区域的日天气数据查询，支持日出日落数据数据查询，支持天气气象图标下载；
 * 2019年6月，新增若干接口，支持约300个城市小时天气数据查询和日数据统计查询，约1000个城市地区的日天气数据查询，并增加了灾害预警数据查询、月级别统计数据的计算；