手搓一个分布式大气监测系统（七）数据开放计划

原创

高树磊

修改于 2021-08-06 17:43:45

7161

修改于 2021-08-06 17:43:45

文章被收录于专栏：腾讯云实践案例腾讯云实践案例

概述

大气监测项目，是一个公益性质的试验性项目。

基于物联网+云原生实现，通过更高频的本地监测能力，获取身边实时的空气质量情况。相关情况，请参考腾讯云云+社区腾讯云实践案例专栏，或直接访问项目文章清单手搓一个分布式大气监测系统

由于物联网系统建设与管理的复杂性，为了降低志愿者的参与难度，项目团队提供了完整的物联网接入及上云处理的解决方案，及开源代码（参考上述文章。硬件源码实时更新，软件源码随机更新）。

当前项目已经积累了超过4000千万条数据，为了能够共建更多样的产品、技术能力，现开放项目数据，以便于志愿者自主实现相关应用，验证想法和目标。

参与项目方式

参与节点建设的志愿者，自主购买硬件后，于项目团队获取对接系统所用的相关配置信息，即可对接入网。

参与应用建设的志愿者，通过本文说明的数据获取方式，可获取全部数据，以支持应用开发。（暂为全部分放，后续视节点志愿者个人意愿，可能对数据获取进行限制）

数据获取方式

历史数据

提供微云下载地址：

链接：https://share.weiyun.com/Pyew1AK1 密码：37m2rh

不定期更新，可获取项目历史数据，并参考“历史数据-数据库表结构”章节，自建数据库存储分析。

实时数据

联系项目团队，获取访问密钥rkey（requestkey）后，参考“在线接口”章节，即可获取信息。

为降低复杂度及应用于腾讯云图等可视化平台的便捷性，当前优先提供静态密钥，访问频率限制为 10次/分钟。

由于是公益团队，我们资金有限，为避免大量访问耗尽项目经费。当前密钥发放方式为邀约制，请联系传播本文的志愿者，由其推荐，并获取密钥。

历史数据-数据库表结构

CREATE TABLE `base_data` (
  `clientid` int(11) NOT NULL DEFAULT '0',
  `spaceid` int(11) NOT NULL DEFAULT '0',
  `time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `PM1_CF1` int(11) NOT NULL,
  `PM2d5_CF1` int(11) NOT NULL,
  `PM10_CF1` int(11) NOT NULL,
  `PM1` int(11) NOT NULL,
  `PM2d5` int(11) NOT NULL,
  `PM10` int(11) NOT NULL,
  `particles_0d3` int(11) NOT NULL,
  `particles_0d5` int(11) NOT NULL,
  `particles_1` int(11) NOT NULL,
  `particles_2d5` int(11) NOT NULL,
  `particles_5` int(11) NOT NULL,
  `particles_10` int(11) NOT NULL,
  `version` int(11) NOT NULL,
  `Error` int(11) NOT NULL,
  PRIMARY KEY (`time`,`clientid`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

字段说明：

clientid ：终端ID
spaceid：地点ID
time：上报时间
PM：标准大气 PM1 指标读数 mg/m3
PM2D5：标准大气 PM2.5 指标读数 mg/m3
PM10：标准大气 PM10 指标读数 mg/m3
其它字段：传感器其它监测信息，详情参考攀藤传感器说明

在线接口

参数说明

名称	用途	必要性
rkey	requestkey 访问密钥	必选
typeid	声明数据请求类别	必选
clientid	终端ID	视接口可选

返回格式

正常返回：json格式数据
异常返回：错误提示信息

接口列表概述

基础地址

https://service-dj8r4c8a-1251286681.gz.apigw.tencentcs.com/release/data_search_lite

参数说明

typeid	用途	刷新时间	接口地址及示例
space_list	获取地点列表	10分钟	基础地址?rkey=****&typeid=space_list
client_list	获取终端列表	10分钟	基础地址?rkey=****&typeid=client_list
last_data_1m	最近1分钟上报数据	1分钟	基础地址?rkey=****&typeid=last_data_1m
last_data_client_1h	指定终端最近1小时上报数据	1小时	基础地址?rkey=**&typeid=last_data_client_1h&clientid=**
client_upcount_30d	指定终端最近30天每天上报数据量	1天	基础地址?rkey=**&typeid=client_upcount_30d&clientid=**
client_average_30d	指定终端最近30天每天平均指标值	1天	基础地址?rkey=**&typeid=client_average_30d&clientid=**
client_average_30d_yt	指定终端最近30天每天平均指标值（云图直读）	1天	基础地址?rkey=**&typeid=client_average_30d_yt&clientid=**
space_totle_data	获取60天内活跃终端列表	1分钟	基础地址?rkey=****&typeid=space_totle_data
space_online_data	获取60天内活跃终端在线列表	1分钟	基础地址?rkey=****&typeid=space_online_data
space_offline_data	获取60天内活跃终端离线列表	1分钟	基础地址?rkey=****&typeid=space_offline_data

信息说明：

刷新时间，用于说明信息更新频率。
在线标准，3分钟内有上报数据。
表中 **** 部分为补全项，参考所获取的rkey及目标节点clientid

接口返回数据说明

字段名	用途
clientid	节点ID
spaceid	地点ID
time	上报时间
PM1	pm1读数 ppm
PMd5	pm2.5读数 ppm
PM10	pm10读数 ppm
upcount	上报次数
lat latitude	纬度
lng longitude	经度
country	国家
province	省份
city	城市
spacename dname	地点名称
status	在线状态数字标识
astatus	在线状态文字标识