《城市生命线工程监测内容、布设及指标、系统功能、传输层接口和协议.docx》由会员分享,可在线阅读,更多相关《城市生命线工程监测内容、布设及指标、系统功能、传输层接口和协议.docx(24页珍藏版)》请在三一办公上搜索。
1、附录A(规范性附录)监测内容、布设及指标A.1燃气设施与管网监测.1.1监测内容XXXA.1.2监测网(点)布设XXXA.1.3监测设备选择XXX(附表)A.2供水设施与管网监测A.2.1监测内容XXXA.2.2监测网(点)布设XXXA.2.3监测设备选择XXX(附表)A.3排水设施与管网监测A.3.1监测内容XXXA.3.2监测网(点)布设XXXA.3.3监测设备选择XXX(附表)A.4热力设施与管网监测A.4.1监测内容XXXA.4.2监测网(点)布设XXXA.4.3监测设备选择XXX(附表)A.5桥梁设施监测A.5.1监测内容XXXA.5.2监测网(点)布设XXXA.5.3监测设备选择X
2、XX(附表)A.6综合管廊设施监测A.6.1监测内容XXXA.6.2监测网(点)布设XXXA.6.3监测设备选择XXX(附表)附录B(规范性附录)监测系统功能城市生命线工程监测系统包括业务应用系统和基础支撑系统。8.1 业务应用系统BL1总体安全运行系统总体安全运行系统须具有以下功能:B.1.1.1风险监测汇聚融合城市安全运行相关各类数据(基础数据、实时监测监控数据等),根据职责定位合理设置报警阈值,实现全方位监测值守和监测报警,对城市实时监测数据和领域报警信息进行综合展示和统计分析,构建基于动态数据的风险监测报警能力,全面掌握城市整体风险态势。1 .实时监测。对监测对象的实时监测数据进行集成
3、处理,实时感知监测对象安全运行状态。分类展示各类监测设备状态和监测数据,按照多种条件查询监测信息列表,包括所在区域、所在位置、设备编号、设备状态、监测时间、实时值等信息,并可查看24小时监测曲线、7天监测曲线、30天监测曲线等。2 .地图空间定位。基于地图可视化展示不同区域监测设备覆盖数量和点位分布,以及监测点附近危险源、防护目标等信息,对于地下管线、桥梁、综合管廊等,通过构建三维场景展示点位分布和状态。3 .报警条件设置。对不同类型数据设置科学合理的报警阈值。实时监测数据一旦大于设定阈值,系统自动响应报警,报警信息可在地图上高亮展示,也可提供声光电联合报警。4 .报警推送。一旦发现报警信息,
4、相关人员对系统自动报警信息进行核查核实,对核实后的警情,按照应急联动处置预案的响应级别形成智能化的信息推送方案,一键推送给相关单位和部门。5 .报警处置跟踪。在地图上使用不同图标展示不同类型的报警信息,报警图标闪烁提示,可查看报警位置、报警时间、报警设备名称、报警级别、监测曲线、处置反馈情况等信息。系统应向报警处置人员提供报警定位、处置反馈功能。6 .报警分析。可以按照年月日等时间维度、不同行业维度、不同区域维度对报警情况进行统计分析,查看报警频次、报警区域分布等态势情况。7 .1.1.2分析预警针对城市运行监测数据和报警数据,结合气象、人口、交通、地质环境等城市基础数据和专业分析模型,分析安
5、全事件可能造成的灾害范围、影响程度和趋势,推进靶向式预警信息发送服务,提升城市风险早期识别和预报预警能力水平。1 .事故预测。根据对监测对象的实时监测数据和报警数据,利用大数据分析技术,并结合专家会商研判,对可能发生的事故类型、事故地点等进行预测,快速生成事故预测报告。2 .风险研判。根据事故预测结果,采用风险评估模型,结合附近危险源、防护目标以及人口、交通和环境等相关要素信息,对事故可能产生的后果及后果严重性进行分析,研判事故风险等级。可基于地理信息系统进行分析和可视化,自动研发风险可能影响的范围。3 .耦合分析。建立多种关联预警评估指标体系和耦合分析模型,对事故可能产生的次生衍生事件、自然
6、灾害诱发技术灾难事件、耦合灾害等进行多维度的评估分析研判,形成综合性、关联性、耦合性的研判分析结果。4 .风险预警。根据事故预测、风险研判以及可能引发次生衍生风险耦合分析结果,形成综合性的风险预警分析报告。根据预警分级规则,自动确定预警级别,形成不同等级的预警信息。B.1.1.3联动处置全面整合城市运行、安全管理、风险防控数据资源,从城市“大应急”角度,构建全链条和跨部门协同处置流程,增强对城市级各种事故灾难、自然灾害和城市综合风险的协同应对能力。1.预警推送发布。根据城市安全监测预警运行管理制度,将城市安全风险预警信息在规定时间内向相关部门和人员推送、发布。(I)预警信息制作。包括预警类型、
7、预警级别、时间、位置、风险大小、周边情况、警示事项等。(2)预警管理。根据预警等级、发布范围、发布渠道等审批流程,完成预警信息推送申请、审核和签发等工作。(3)预警推送。采用系统或者电话、传真、短信、APP等方式,将预警信息推送到有关权属单位、相关部门、政府机构和相关责任人,并设置已读、回复等确认要求。(4)公众发布。建立与移动、电信、联通等电信运营商,广播、电视、电子显示屏以及人民防空警报系统等各类灾害预警系统的通信联络,以及与互联网新媒体平台等的信息对接机制,根据需要通过上述渠道向公众发布预警信息。(5)预警解除。警情处置完成后,及时发布解除预警信息。2 .分级响应。系统根据事件类型、预警
8、级别等,自动关联相应预案,能够基于预案自动推送事件相关城市生命线安全风险权属管理、行业监管和安全主管应急等部门负责人,进行分级响应和处理。(1)自动关联。根据事件类型、预警级别等,自动关联相应预案,确定需要采取措施的相关权属单位、政府部门和有关责任人,根据预案要求自动生成任务分配方案。(2)智能推荐。根据实时监测数据和研判预警情况,利用辅助决策知识库,向相关部门和人员提供响应措施要点、注意事项等知识查询和智能推荐服务。(3)现场反馈。向相关部门和人员提供处置反馈功能,并利用人员定位、音视频通信等手段,对分级响应的过程进行实时跟踪,对响应处置不及时的进行督办和提醒。3 .应急联动。在灾害事故发生
9、时,实现跨部门的信息共享、任务下达、资源调度等功能,实现突发事件的快速、高效、科学、联动处置。(1)指挥方案。根据灾害事故级别和应急预案,自动生成应急指挥方案,智能关联应急救援力量和物资保障信息,形成相关力量部署方案,生成任务分配方案。(2)应急调度。布置救援工作和调度相关应急资源,向相关单位和人员共享灾害事故信息,下达应急救援任务。(3)融合通信。为各类用户提供实时文字、话音、图像、视频的融合通信保障,确保信息上传下达畅通,保证事故灾害现场连得上、看得见、呼得通。(4)专家会商。建立各行业领域专家库,形成即用即联、实时在线的专家快速联系、在线会商机制,让专家全程参与应对处置工作,提供科学决策
10、支持。(5)处置跟踪。及时跟踪处置过程,标绘现场情况,汇总灾害信息,并通过跟踪表、地图等方式进行展现处置工作进展和工作序列,直至应急处置工作全部完成。(6)档案记录。实现从感知监测数据参数异常、报警类型和报警级别、警情推送、现场处置过程记录、现场处置反馈报告等全过程的内容,作为事件追溯分析和大数据统计分析的依据。2 .1.2燃气专项运行监测系统燃气专项运行监测系统须,除上述总体安全运行系统功能外,还应具有以下功能:1 .燃气信息资源管理含管网基础数据管理、厂站基础信息管理、危险源信息查询、防护目标信息查询等。对工商业燃气用户、阀门井(室)、泄漏报警检测终端、人员的档案管理。档案信息包括工商业燃
11、气用户、阀门井(室)名称、编号、位置、建设时间、维修记录、巡检记录、终端参数、调零记录、维护记录、配置记录等。2 .燃气管网风险评估含风险评估清单、风险评估四色图、风险评估报告等。3 .燃气隐患管理含隐患台账、隐患审核推送、隐患整改跟踪、隐患整改反馈、隐患上报、隐患一张图等。4 .燃气监测预警含站点实时监控,包括各调压站、输配站、天然气管线的压力监测、温度监测、流量监测;重要设备的电源监控、阀门监控、视频监控等;历史数据浏览、分析;泄露报警、水位变化等信号进行异常突变报警;固定值报警,报警限值曲线可以伴随实测值曲线同时展示;固定值报警将设置阀门井(室)内泄漏浓度报警上下限。5 .燃气预测研判分
12、析结合GIS服务系统和BIM模型,进行管道燃气泄露溯源分析、管道燃气泄露扩散分析、管道泄露爆炸预测分析,综合周边危险源、防护目标、报警超限时长、密闭空间大小、人员密集环境和报警发生时间段等因素,预测财产损失。6 .燃气泄漏辅助管理含智能研判分析报告、安全评估报告、知识库、窠例库、专家陆、统计分析等功能。3 .1.3供水专项运行监测系统供水专项运行监测系统须,除上述总体安全运行系统功能外,还应具有以下功能:4 .基础数据管理含管网基础数据查询、管网数据统计分析、管网分析报表导出等;5 .风险评估管理含评估报告管理、评估报告生成、评估报告打印导出等;6 .实时监测与报警含管网运行监测、管网运行监测
13、分析、实时报警灯7 .预测预警含管网保管预警分析、大面积停水预测预警、用水趋势分析等;8 .供水辅助决策含辅助关阀分析、管线模拟开挖、事件统计分析、供水安全评估报告等;9 .水质安全保障含饮用水安全基础信息管理、饮用水源地水安全监测预警溯源、城市水厂水安全监测预警溯源等;1 .1.4排水专项运行监测系统排水专项运行监测系统须,除上述总体安全运行系统功能外,还应具有以下功能:2 .基础数据管理含排水基础数据查询、排水基础数据统计分析等;3 .实时监测与报警含排水运行监测、监测分析、阈值设置、监测报警等;4 .排水安全风险评估含排水管网淤积风险评估、排水管网溢流风险评估、排水管网渗漏风险评估、排水
14、管网综合风险评估、内涝风险评估等;5 .预测预警分析含排水管网溢流预测预警分析、城市内涝预测预警分析等6 .辅助决策含排水风险数据统计、排水评估报告等7 .1.5热力专项运行监测系统XXX1 .1.6桥梁专项运行监测系统桥梁专项运行监测系统须,除上述总体安全运行系统功能外,还应具有以下功能:2 .基础信息管理含桥梁基本信息、桥梁构建管理、振型管理、布点方案管理、计算模型管理、设备分组管理、联系人管理、桥梁信息统计等;3 .桥梁实时监测和分析含桥梁实时监测、数据预处理、数据质量检测、数据分析管理等;4 .监测预警含桥梁监测报警处置、模态频率预警、阈值设置、报警信息统计、三维可视化管理等;5 .安
15、全评估含桥梁安全评估报告、安全评分管理、安全评分分析、模型配置管理等;6 .监测养护管理含检测报告管理、维修养护数据管理、维修养护计划管理、检测养护计划管理、检测养护记录管理等;7 .辅助决策支持含事件管理、案例管理、预案管理、处置方案管理、知识库管理、养护建议管理等;8 .1.7综合管廊专项运行监测系统XXXB.2基础支撑系统8.2.1 物联感知系统物联感知系统提供安全可靠的连接通信能力,向下连接海量设备,支撑设备数据采集上云,向上提供云端API,服务端通过调用云端API将指令下发至设备端,实现远程控制,为设备上云提供支撑。物联感知系统应具有以下功能:1.产品定义1 1)应支持直连设备和非直
16、连设备的创建、查询、更新、删除操作,及产品物模型定义。2 2)应支持设备厂商的创建、查询、更新、删除操作。3 .设备接入(1)应支持多种传输通信协议(如MQTT、HTTP、HTTPS等),并符合“附录C”中的相关规定。(2)应支持手动注册和自动动态注册两种注册方式。(3)应支持实时或定时增量数据采集,宜提供实时同步、定时采集、数据订阅、日志采集等服务。(4)应支持采集作业管理和调度,采集作业支持条件触发、并发调度、周期循环调度等模式,应支持对作业启动、停止、暂停、恢复等操作。(5)应对数据的标准代码、格式、类型等进行转换,必要时,可建立“数据转换规则表”。4 .设备管理(1)应支持多维度的设备
17、检索功能,包括但不限于通过设备名称、设备ID、设备状态、所属产品、设备厂商、安装位置、接入方式、告警状态、设备标签、设备类型等字段进行检索。应支持检索后的批量导出功能。(2)应支持基于地图的设备可视化展示方式。(3)应支持对设备进行群组和标签管理。(4)应支持将各种设备管理命令功能适配为统一的资源访问API提供给业务系统使用。5 .一机一档(1)应支持设备基础信息的创建、查询、更新、删除操作,包括但不限于设备基础信息、设备从属信息、设备标签、设备与平台连接的密钥等。(2)应支持图、表等形式查看设备及设备下属传感器历史数据的功能。5 .监控运维(1)应支持设备OTA升级与管理服务,可指定差分、灰
18、度、全量等多种升级策略。(2)应支持设备日志查询功能,辅助运维人员进行故障分析,提升故障定位效率。(3)应支持根据设备状态、消息、报警等行为数据,实现远程诊断功能。(4)应支持远程配置功能。开发人员在不重启或中断设备运行的情况下,在线远程更新设备的系统参数、网络参数等配置信息。(5)应支持自定义异常规则配置、解除规则配置,实现单设备、多设备的异常预警。6 .数据共享应支持服务端订阅、场景联动等方式,通过配置规则,实现设备、服务器、物联网平台之间消息的同步、转化、过滤、存储等功能。7 .安全防护(1)应建立统一的标识安全管理和身份鉴别机制,保证感知设备的合法接入。(2)数据在整个采集、转化、传输
19、过程中应依据授权使用,不被非法冒充、窃取、篡改、抵赖。(3)应采用安全技术维护数据安全,包括但不限于对称与非对称密码技术及其硬化技术、VPN技术、身份认证与鉴别技术、CPK技术、CeKS技术、完整性验证技术、数字签名技术、秘密共享技术等。8. 2.2视频融合系统视频融合系统由图像信息接入模块、图像信息汇聚模块、图像信息管理模块三个部分构成,能实现对高清图像的采集、传输、显示、存储、回放、控制和管理等基本功能。1 .图像信息接入模块图像信息接入模块实现对前端图像资源的信号采集、图像的显示、存储、控制、转发、报警联动;向上级汇聚模块报告系统运行状态、事件信息,接受并执行上级模块下达的控制信令的任务
20、;对本地历史图像进行检索、回放。2 .图像信息汇聚模块图像信息汇聚模块对接入模块上传实时图像进行本地显示、控制,对重要事件信息进行存储,对接入历史图像进行检索与回放,并具有转发功能。同时承担向上级管理模块报告本地系统运行状态与事件信息、接受并转发上级模块的决策信息与控制信息的任务。3 .图像信息管理模块图像信息管理模块具有图像信息汇聚模块上传的视频图像本地显示、控制、接收报警信息、对重要事件和突发事件信息进行存储,对全网历史图像资源进行检索、回放和向上级业务平台转发图像与相关信息的功能。视频融合系统应具有以下功能:(1)设备管理a.应支持实时监测摄像机、云台、模拟视频矩阵、操作键盘、画面处理器
21、、字符叠加器、视频分配器、视频编解码设备、存储设备等主要设备的工作状态。b.应支持设备故障识别、定位,发生故障时进行多媒体声音及图像报警并可打印报警报告。c.应支持实时监测运行中的服务器的磁盘空间、进程数量、用户数量、内存、CPU使用情况等参数;应监测进程状态、进程占用CPU时间、进程内存使用情况。(2)视频调阅a.应支持城市生命线工程监测系统内多个用户同时访问同一个资源点的视频信息。b.应支持自动循环方式或手动选择方式,在系统中显示单画面或多画面图像。c.应支持自定义编组的功能。(3)存储与回放a.应支持分用户权限进行远程下载和调阅管辖范围任意视频录像,可对录像进行光盘刻录复制。b.应支持本
22、地接入的全部图像进行实时存储,对报警联动图像进行备份存储。c.应支持按图像来源、录像时间、摄像机位置、日期范围及相关属性等进行历史图像的分类检索及回放。(4)智能视频分析应支持智能视频分析功能的手动启动和停止,能根据时间设定进行布防和撤防操作。8. 2.3通信网络系统通信网络系统应具有以下功能:1 .数据传输应支持基于消息和文件的传输方式。消息传输应支持异步和同步消息传输机制,应支持低时延(实时/准实时)、高并发的消息传输能力。文件传输应支持大规模文件传输和数据压缩、解压机制。并符合“附录C”中的相关规定。2 .安全防护(1)应支持对网络设备、通信线路、传输数据、协议和移动终端等的安全防护与检
23、测,避免未授权访问、干扰、窃听和损坏,保证网络通信的连续性和可靠性。(2)除基础的网络防御措施外,应具备全网络安全态势检测、分析和防御能力,以及新型和高级威胁检测、分析、预警和防御能力。8. 2.4数据治理系统数据治理系统应具有以下功能:1 .数据预处理(1)应支持全量抽取、增量抽取、基于日志抽取等数据抽取模式,应支持地理空间信息数据的抽取。(2)数据加工应实现数据的特征识别、提取和转换。(3)应支持对错误数据、无效数据、重复数据等异常数据的处理。(4)应支持对数据不一致性的监测。2 .数据存储(1)应支持时序型数据库存储实时性数据,用于监测、检查设备所采集的实时数据。(2)应支持关系型数据库
24、存储历史性数据,用于分析优化管理过程。(3)应提供存储调度、存储监控、存储管理的可视化管理界面。3 .数据分析(1)应支持基于分布式并行计算处理框架的分布式挖掘分析。(2)数据挖掘应支持多种算法,包括但不限于关联分析、聚类分析、分类分析、异常分析、特异群组分析盒演变分析等。4 .数据分发(1)应支持结构化数据、半结构化数据、非结构化数据、GlS数据等不同类型的数据分发。(2)应支持满足数据接收方要求的数据过滤机制,减少无用数据的传输和接收。(3)应保持数据分发过程的实时性和可靠性。5 .安全防护(1)应对特定敏感字段或业务数据使用加密方式存储。(2)应支持国家密码管理主管部门批准使用的密码算法
25、,使用国家密码管理主管部门认证核准的密码产品,遵循相关密码国家标准和行业标准。(3)应按照国家相关保密部门要求采用合适的加密算法、密钥长度和密钥管理机制。B.2.5二三维GIS系统二三维GIS系统提供在线地图、标准服务接口、应用开发接口和运维管理等服务,支撑城市生命线工程监测系统中各业务系统在线获取地理信息,快速构建专题应用。二三维GIS系统应具有以下功能:1 .地理数据归集应支持城市生命线工程监测所涵盖的所有地理数据,包括地理要素的几何数据、属性数据或描述地理覆盖的影像数据、栅格数据及相应的元数据。2 .地图搜索(1)应支持在给定条件下,用包含(like)、等于(=)、大于()、小于()、不
26、等于()等标准的SQL查询语言,进行形式化描述表达;(2)应支持通过设置查询的图层和图层相对应的字段,在该范围搜索符合条件的结果。3 .空间查询(1)应支持在给定的矩形范围、圆形范围、多边形范围,或者点位及某点位的周边范围,可设置查询的图层和图层相对应的字段,在该范围搜索符合条件的结果。4 .统计分析(1)应支持在给定的矩形范围、圆形范围、多边形范围,或者某一行政区域范围,可设置统计的图层和图层相对应的字段,在该范围搜索符合条件的结果,并进行统计。(2)统计结果应支持用柱状图、饼状图和直方图等形式表现。5 .信息标注(1)应支持包括点、线和面三种标注方式,可便捷设置符号样式、添加属性信息和说明
27、信息,并链接图片、声音、录像等多媒体资料。(2)标注的信息内容应支持分类分组管理,或进行修改操作及设置其共享范围。B.2.6应用支撑系统应用支撑系统承载城市生命线工程监测系统中业务系统的通用功能支撑,包括用户权限管理、日志管理、数据备份与恢复等。应用支撑系统应具有以下功能:1 .目录管理应支持目录编制、目录发布和元数据管理等功能,对平台的目录进行管理。2 .用户管理(1)应具备独立的认证鉴权功能,应对访问系统的用户身份进行合法性认证。(2)应限制用户端登录使用的IP地址。应限制用户多点登录。(3)应将用户至少分为管理用户和普通用户两大类。管理用户能够对系统软硬件资源、系统运行状态以及安全配置进
28、行管理。普通用户可以查看和使用系统的业务功能。3.日志管理(1)应支持记录系统运行日志盒操作日志。运行日志包括模块的启动、停止,系统用户的注册、注销等操作信息。操作日志包括管理用户的登录、退出、配置操作等使用信息。(2)运行日志及操作日志的存储时间应不少于6个月。(3)应支持日志的统计分析,生成日志分析报表。4.安全机制应支持服务安全、数据分级、传输加密、用户权限、操作审计、数据备份与恢复等功能,保障数据的安全传输与访问控制。B.3运维应用系统运维应用系统支撑城市生命线工程监测系统中感知设备的运维管理,包括设备状态监控、数据异常监控、工单管理等。运维应用系统应具有以下功能:1 .运维大盘应支持
29、基于地图的数据展示,包括但不限于设备分布、设备统计、异常统计、实时预警信息、工单信息展示等。2 .设备运维(1)应支持设备拓扑管理、上/下线、发起检修等操作。(2)应支持设备标签的新建、查询、修改、删除操作。3 .异常监控(1)应支持无数据异常甄别功能,根据设备上报的数据情况,自动识别长时间无正常协议上报的设备,进行预警。(2)应支持数据超阈值异常报警功能,根据设备上报的数据情况,自动识别超阈值设备,进行预警。(3)应支持数据异常甄别功能,根据设备上报的数据情况,自动识别异常数据值,进行预警。(4)应支持异常自动派发工单功能。4 .故障预测应支持数据预测功能,根据设备上报的电量值,预判断电时间
30、,进行预警。5.检修服务应支持日常巡检、异常工单的新建、派发、处置、挂起、督办等操作。附录C(规范性附录)传输层接口和协议C.1接口分类与协议结构C.1.1接口分类城市生命线工程监测系统的接口包括数据采集接口、数据服务接口、分析接口。(I)数据采集接口用于城市生命线工程监测感知设备与物联网平台之间的数据交互。(2)数据服务接口用于物联网平台与业务系统之间的数据交互。(3)分析接口用于数据治理系统与业务系统之间的数据交互。C.1.2协议结构接口交互连接方式支持HTTP长连接和短连接。传感器和数据采集系统之间通过MQTT协议和TCP协议通讯。数据采集系统采用的是自研MQTTBrOker服务器,Br
31、Oker启动后,任何设备或终端可通过MQTT协议连接到服务器,通过发布(PUbliSh)或订阅(SUbSCribe)进行交换消息。数据采集系统采用的是socket和传感器之间进行通讯。数据发送方和数据接收方的成对的两个socket之间必须建立连接,以便在TCP协议的基础上进行通信,当一个SoCket(通常都是SerVerSOCket)等待建立连接时,另一个SoCket可以要求进行连接,一旦这两个socket连接起来,它们就可以进行双向数据传输,双方都可以进行发送或接收操作,见图C-1。服务器端客户端图C-Isocket通讯流程图C.2接口功能C.2.1公共功能应支持系统的登录和登出。C.2.2
32、采集接口应支持采集设备、采集系统向业务系统监测系统数据库自动上传数据。应支持业务系统向采集系统进行采集设备或采集系统的查询,向采集设备发布相关指令。C.2.3数据服务接口应支持城市生命线工程监测系统和其他信息系统等向城市生命线工程监测系统数据库进行基于监测数据对象等特征属性及其组合的查询。应支持其他信息系统向城市生命线工程监测系统数据库进行采集设备或采集系统等的查询、更新。应支持城市生命线工程监测系统和第三方系统的数据交互。应支持城市生命线工程监测系统报告管理系统的复杂逻辑处理。C.2.4分析接口应支持城市生命线工程监测系统对城市生命线工程监测系统数据库分析任务的下发、启动、暂停、停止以及分析
33、规则的创建、更新或删除。应支持城市生命线工程监测报告管理系统多维度、多方面生成数据报告。C.2.5接口资源描述接口资源统一由城市生命线工程监测系统数据库管理,不同接口可以调用库中不同的资源进行不同业务逻辑处理。接口调用第三方平台(例如短信平台)的日志信息要进行入库存档。接口不能删除采集系统上报的原始数据。C.3接口消息C.3.1数据接口之HTTPC.3.1.1HTTP方法:表CTHTTP方法列表HTTP方法描述POST新增资源信息PUT更新资源信息GET查看资源信息DELETE删除资源C.3.1.2支持的返回码列表表C-2支持的返回码列表HTTP返回码含义详细描述200OK在HTTPbody中
34、以json格式指明详细成功或错误信息,例如:(message:success”1status:okdata:)message:返回消息悬义status:返回内容状态data:可选,返回内容包含具体数据400BadRequest401NotAuthorized403Forbidden404NotFound406NotAcceptable422UnprocessableEntity500InternalServerError502ServiceNotAvailable503NoservererrorC.3.1.3HTTP报文格式示例POST/devices/1012/datapoints?type
35、=lHttp/1.1key:xxxxxxxxxxxxxxxHost:incX:0.10zincYO2C.3.2数据点上传C.3.2.1数据点上传格式表C-3数据点上传格式列表HTTP方法POSTURLHTTP头部key:xxxxHTTP内容有多种数据格式,详细见C.4.2.2。请求返回(message/success”,.status:ok,data:)说明:(1)可以一次性上传多个数据点;(2)数据点上传支持不同格式的数据内容上报,格式见数据点上传内容;C.3.2.2数据点上传内容(1)实时数据上报表C-4实时数据上报列表Urldevicesdatapoints?type=l格式,zitem
36、z:value,“item2:value2,厂示例incXO.10,incY,0.12说明实时数据上报类型参数为3,内容中不带有时间戳,数据点时间即数据上报时间(服务器当前时间)。支持不同监测内容数据点同时上报(2)带时间戳数据上报表C-5带时间戳数据上报列表Urldevices/datapoints?type=2格式(zzitemlzz:“yyyy-MM-ddHH:mm:ss,z:valuel,zyyyy-MM-ddHH:mm:ss:value2,yyyy-MM-ddHHvalue3示例incX:,z2018-06-2710:20:12,z:O.1),zinc:zz2018-06-2710:
37、20:12:0.2)说明带有时间戳数据上报类型参数为2,时间戳格式为yyyy-MM-dd该内容只支持单个数据点上报,支持不同监测内容数据点同时上报(3)历史数据上报/多数据点上报表C-6历史数据上报/多数据点上报列表Urldevicesdatapoints?type-3格式(item:item!,“datapoints:(zztimez,:“yyyy-MM-ddHH“value:valuel,示例(item:ncX,“datapoints:(time:2018-06-2710:20:12,“value:0.1,(item:IncY,“datapoints:(“time:2018-06-2710
38、:20:12,“value:0.2),(“time:2018-06-2710:20:12,“value:0.3),(“value:0.3说明历史数据上报/多数据点上报类型参数为3,时间戳格式为yyyy-MM-dd其中数据点datapoints内时间可省略,省略则代表当前时间(4)相关数据上报表C-7相关数据上报列表Urldevicesdatapoints?type=4格式:“items:zzdatastreamK,zzdatastream2zz,.data”:(“yyyy-MM-ddHH:mm:ss:valuel,value2,.,示例(items:Lfrequency,amplitudeJd
39、ata:(,z2018-07-2910:22:22:1,2.1,z2018-07-2910:22:22:2,2.5,2018-07-2910:22:22”:3,2.8),(J1应用场景多个数据点是具有一定的相关性,比如说振幅和频率限制每一组item的个数要与data中的VaIUe的个数一致。Item最大长度不能超过5o时间戳格式为yyyy-MMYdss0(5)GPS数据上报表C-8GPS数据上报列表Urldevices/datapoints?type=gps格式yyyy-MM-ddHH:mm:ss:zzvaluex,valuey,VaIUeZ,)示例(zz2018-06-2710:00:00:
40、zz1.32,1.65,1.8。z/2018-06-2711:00:00:zz1.35,1.6,1.2)说明GPS数据上报格式为时间:X轴,y轴,h轴,时间戳格式为yyyy-MM-dd支持多数据点上传备注:所有的监测项(item)需要符合附录D.1.2设备类型与监测类型对应表中的监测类型,并且GPS数据单位由上传方进行相应转换。所有接收数据均为结果值。C.3.3数据点查询C.3.3.1数据点查询格式与内容表C-9数据点查询格式与内容列表Url请求头key=请求方式GET请求参数参数key是否必填类型/格式含义start否stringyyyy-MM-ddHH:mm:ss数据点查询开始时间,若不填
41、默认为为距end最近一条数据end否stringyyyy-MM-ddHH:mm:ss数据点查询结束时间,若不填默认为当前时间items是string多个item通过字符串分割监测项,根据上传的监测项sort否stringDESCIASC返回数据的排序方式,DESC为降序,ASC为升序数分及回部式例返据格示(item:ncX,“datapoints”:(:2018-08-1416:00:00,“value”:1.3),(/7zitem:ncY,“datapoints”:)注意该接口返回的数据点最大数量不能超过IOk个。C.4消息交互流程C.4.1创建资源消息交互流程实现数据采集流程,发起者按照接
42、口访问形式向接收者发送HTTPPOST请求,接受者将请求成功与否的相应返回给发起者,见图C-2。1:POST/DEVICEydatapoints2:message:uccess,status:kfdata)图C-2创建资源消息交互流程图C.4.2读取资源消息交互流程实现发起者向接收者进行数据查询。发起者按照接口访问形式向接收者发送HTTPGET请求,接受者将请求成功与否的相应数据返回给发起者,见图C-2。图C-3读取资源消息交互流程图C.5消息交互安全性消息交互的双方应进行身份认证保证交互的安全性,另外使用REST风格的接口设计,保证接口的可靠性。C.5.1REST概述REST即表述性状态传递
43、(英文:RepresentationalStateTransfer,简称REST)是RoyFieIding博士在2000年他的博士论文中提出来的一种软件架构风格。它是一种针对网络应用的设计和开发方式,可以降低开发的复杂性,提高系统的可伸缩性。C.5.2REST和HTTP方法表C-IOREST和HTTP方法描述表HTTP方法描述POST新增资源信息PUT更新资源信息GET查看资源信息DELETE删除资源GET调用不能改变系统状态,这表示该调用只返回数据给请求者而不会产生任何副作用。POST只能用于添加原先不存在的资源的场合。PUT一般用于更新已经存在资源的场合,但如果指定的资源不存在,也可以创建
44、该资源。DELETE一般用于删除资源。C.5.3REST和HTTP响应状态码表C-IlREST和HTTP响应状态码HTTP返回码含义详细描述200OK在HTTPbody中以json格式指明详细成功或错误信息,例如:(message:successstatus:okdata:)message:返回消息意义status:返回内谷状态data:可选,返回内容包含具体数据400BadRequest401NotAuthorized403Forbidden404NotFound406NotAcceptable422UnprocessableEntity500InternalServerError502ServiceNotAvailable503Noservererror