documentation.md 4.0 KB

说明

本天气服务(EMS_Weather),以购买的第三方天气数据服务商(心知天气,https://www.seniverse.com/)的接口为数据源,通过a转发请求,b定时任务将数据存库两种方式来获取天气数据,并提供相关查询接口;

天气数据说明

单位

接口返回数据默认单位说明:

  • 温度(体感温度),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³

空气质量枚举值

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

天气现象编码与天气气象文字枚举值

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

灾害预警

  • 类型:["台风", "暴雨", "暴雪", "寒潮", "大风", "沙尘暴", "高温", "干旱", "雷电", "冰雹", "霜冻", "大雾", "道路结冰", "雷雨大风"]
  • 灾害级别:["白色", "蓝色", "黄色", "橙色", "红色"]

支持的气象指标

小时级别数据

温度、体感温度、相对湿度、气压、能见度、气象文字、风向、风向角风速、风力等级、空气质量、云量、pm25、pm10、so2、no2、co、o3

日级别数据

  • 日概况数据:最高温、最低温、白天气象文字、夜晚气象文字、风力等级、风向、风速、降水量
  • 统计数据:以下指标的最大最小值以及均值,[温度, 相对湿度, 风速, 气压, 能见度]

灾害预警数据

16种灾害类型:台风, 暴雨, 暴雪, 寒潮, 大风, 沙尘暴, 高温, 干旱, 雷电, 冰雹, 霜冻, 大雾, 道路结冰, 雷雨 大风

数据类型(按时间划分)

24小时预报

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

14日预报

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

小时数据历史记录(最早2017.01.01开始)

温度、相对湿度、气象文字、气压、能见度、风向文字、风速、风向角风速、风力等级、(2020.07.01之前不包含以下指标)体感温度、空气质量、云量、pm25、pm10、so2、no2、co、o3

日历史数据(最早2017.01.01开始)

[温度, 相对湿度, 风速, 气压, 能见度]的最大(最小,平均)值、白天\夜晚气象文字、风向文字、风速、风向角风速、风力等级、(2020.07.01之前不包含以下指标)白天夜晚\气象代码、降雨量

支持城市

  • 小时级数据和日统计数据支持1189个城市地区(涵盖全国所有一、二、三、四、五线城市的市级,市属区级)
  • 日天气数据和灾害预警数据支持3000+个城市地区(几乎涵盖全国所有地区)