概述
大气监测项目，是一个公益性质的试验性项目。
基于物联网 云原生实现，通过更高频的本地监测能力，获取身边实时的空气质量情况。相关情况，请参考腾讯云 云 社区 腾讯云实践案例 专栏，或直接访问项目文章清单手搓一个分布式大气监测系统
由于物联网系统建设与管理的复杂性，为了降低志愿者的参与难度，项目团队提供了完整的物联网接入及上云处理的解决方案，及开源代码（参考上述文章。硬件源码实时更新，软件源码随机 更新）。
当前项目已经积累了超过4000千万条数据，为了能够共建更多样的产品、技术能力，现开放项目数据，以便于志愿者自主实现相关应用，验证想法和目标。
参与项目方式
参与节点建设的志愿者，自主购买硬件后，于项目团队获取对接系统所用的相关配置信息，即可对接入网。
参与应用建设的志愿者，通过本文说明的数据获取方式，可获取全部数据，以支持应用开发。（暂为全部分放，后续视节点志愿者个人意愿，可能对数据获取进行限制）
数据获取方式
历史数据
提供微云下载地址：
链接：https://share.weiyun.com/Pyew1AK1 密码：37m2rh
不定期更新，可获取项目历史数据，并参考“历史数据-数据库表结构”章节，自建数据库存储分析。
实时数据
联系项目团队，获取访问密钥rkey（requestkey）后，参考“在线接口”章节，即可获取信息。
为降低复杂度及应用于 腾讯云图 等可视化平台的便捷性，当前优先提供静态密钥，访问频率限制为 10次/分钟。
由于是公益团队，我们资金有限，为避免大量访问耗尽项目经费。当前密钥发放方式为邀约制，请联系传播本文的志愿者，由其推荐，并获取密钥。
历史数据-数据库表结构
代码语言：txt复制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 | 在线状态 文字标识 |
