1、服务介绍

1.1 概述

1）电子巡更是管理者考察巡更者是否在指定时间按巡更路线到达指定地点的一种手段。巡更系统帮助管理者了解巡更人员的表现，而且管理人员可通过软件随时更改巡逻路线，以配合不同场合的需要。
2）电子巡更包含设备管理和数据管理两个部分

• 设备：巡更点、巡更设备的设备实时状态，
• 数据：巡更人员管理、巡更路线管理、巡更计划管理、巡更计划等
  

1.2 数据字段说明

1）DateTime

使用时间截

2）Integer类型

数据模型中的Integer类型统一为整数类型，支持BigInt。

3）坐标参数

为了兼容坐标的表示方案，坐标参数的数值表示前，加坐标系的说明。
格式：

• 坐标点：<坐标系>:< lat>,< lon>
• 坐标序列：<坐标系>:< lat>,< lon>[,< lat>,< lon>]*
• lat: 纬度，lon: 经度

坐标系取值：

• WGS84 国际坐标系，为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
• GCJ02 火星坐标系，是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
• BD09 为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标

4）日期参数

日期参数以String类型表达

• 格式：yyyy-MM-dd

5）时间参数

时间参数以String类型表达

• 时间格式：yyyy-MM-dd HH:mm:ss

1.3 设备信息

1）巡更设备物模型

点此下载巡更设备

属性

属性	字段	类型	备注
地理位置	GeoLocation	struct (结构体)
	-Longitude	double	地理位置经度，高德坐标系
	-Latitude	double	地理位置纬度，高德坐标系
	-Altitude	double	地理位置高，单位m

事件

事件	参数	字段	类型	备注
巡检上报事件 ReadRfidCardEvent	巡检点标示	Rfid	varchar(64)
	时间	Timestamp	long	精确到毫秒
	打卡位置	Location	varchar(32)	如122.33322,36.98884
缺陷上报事件 AlarmEvent	缺陷标示	AlarmId	long
	缺陷名称	Name	varchar(256)
	缺陷类型	Type	long
	缺陷描述	Description	varchar(512)
	时间	Timestamp	long	精确到毫秒
	打卡位置	Location	varchar(32)	如122.33322,36.98884

服务

无

2）巡更点物模型

点此下载巡更点

属性

无

事件

事件	参数	字段	类型	备注
巡检上报事件 ReadRfidCardEvent	巡更设备Id	ReaderId	varchar(64)
	时间	Timestamp	long	精确到毫秒
	打卡位置	Location	varchar(32)	如122.33322,36.98884

服务

无

1.4 巡更系统

1）人员信息 - patrolUser

版本：1.1
巡检人员的基本信息，其中角色可以自定义扩展。

字段	名称	类型	必填	说明
userID	用户ID	Integer	是
userName	用户姓名	String(64)	是
phone	手机号	String(32)	否
ridDepartmentID	部门ID	Integer	否
role	角色列表	Integer	否	0:管理员 1:普通巡检人员
gmtCreated	创建时间	DateTime	是
gmtModified	修改时间	DateTime	是
version	数据版本	Integer	是	从1开始，每次修改时增1

2）部门信息 - patrolDepartment

版本：1.0
部门基本信息，用来定义组织结构。

字段	名称	类型	必填	说明
departmentID	新创建的部门ID	Integer	是
departmentName	部门名称	String(64)	是
province	省份	String(32)	否
city	城市	String(32)	否
ridParentDepartmentID	上级部门ID	Integer	否	默认创建一级部门
idPath	部门节点的ID路径	String(1024)	否
gmtCreated	创建时间	DateTime	是
gmtModified	修改时间	DateTime	是
version	数据版本	Integer	是	从1开始，每次修改时增

3）巡检路线 - patrolLine

巡检路线与巡检点之间是聚合关系，有两种使用方式：

1. 用patrolNode.ridLineId关联巡检路线
2. 用patrolLine.nodeIdList关联巡检点

方式2的巡检点可复用，方式1的巡检点便于统计查询。业务方根据实际情况使用。
版本：1.0

名称	名称	类型	必填	说明
lineID	巡检路线ID	Integer	是
lineName	巡检路线名称	String(64)	是
ridDepartmentID	部门ID	Integer	否
memo	描述	String(512)	否
coordinates	坐标序列	String(1024)	否	格式见“通用数据说明”中的“坐标参数”节
nodeIdList	巡检点ID列表	String(1024)	否	JOSN格式，例：[“xx1”,”xx2”] 当nodeId为64位时, 最大保存15个ID值。如果有需要可以扩展
gmtCreated	创建时间	DateTime	是
gmtModified	修改时间	DateTime
version	数据版本	Integer	是	从1开始，每次修改时增1

4）巡检点 - patrolNode

版本：1.1
巡检点基本信息，card为巡更点设备Id，ridLineID巡检点所在路线。

名称	名称	类型	必填	说明
nodeID	巡检点ID	Integer	是
nodeName	巡检点名称	String(64)	否
card	巡检点卡号	String(64)	否
type	点位类型	Integer	是	0 - GPS点位 1 - 真实点位
ridLineID	线路ID	Integer	否
orderNum	排序号	Integer	否	点位在线路上的排序号
intervalTime	间隔时间	Integer	否	单位：分钟 指2个巡检点之间的打卡间隔时间（这个属性是配合计划使用，在对时间要求特别严格的时候才会用到）
ridDepartmentID	部门ID	Integer	否
memo	描述	String(512)	否
coordinate	坐标点	String(128)	否
gmtCreated	创建时间	DateTime	是
gmtModified	修改时间	DateTime	是
version	数据版本	Integer	是	从1开始，每次修改时增1

4）工作计划 - patrolPlan

版本：1.1

名称	名称	类型	必填	说明
planID	工作计划ID	Integer	是
planName	计划名称	String(64)	是
ridParentPlanID	上级计划ID	Integer	否
ridLineID	线路ID	Integer	否
ridUserID	巡检人ID	Integer	否
ridDepartmentID	部门ID	Integer	否
startDate	开始日期	DateTime	是
endDate	结束日期	DateTime	是
startTime	开始时间	DateTime	是
endTime	结束时间	DateTime	是
planCrontable	计划巡检周期	String(32)	否	计划巡检周期，crontable格式
week	触发星期	String(32)		如周一和周三执行： mon,wed 注意，以逗号分隔，无空格，星期值为星期的小写缩写形式
planType	计划类型	Integer	是	0 - 按星期 1 - 按天
interval	间隔天数	Integer	否	如每2天执行巡检
planNum	巡检次数	Integer	否	通常都是1，结合interval使用，表示每interval天执行planNum次巡检
fixedOrder	固定顺序	Boolean	否
fixedTime	固定时间	Boolean	否
offsetTime	误差时间	Integer	否	单位：分钟，当fixedTime为true有效
patrol	巡检时长	Integer	否	单位：分钟
rest	休息时长	Integer	否	单位：分钟
gmtCreated	创建时间	DateTime	是
gmtModified	修改时间	DateTime	是
version	数据版本	Integer	是	数据版本，从1开始。每次修改时增1

5）计划考核 - patrolPlanCheck

版本：1.0

名称	名称	类型	必填	说明
planCheckID	工作计划ID	Integer	是
ridLineID	线路ID	Integer	否
ridNodeID	巡检点ID	Integer	否
ridUserID	巡检人ID	Integer	否
ridDepartmentID	部门ID	Integer	否
startTime	开始时间	DateTime	是
endTime	结束时间	DateTime	是
fixedStartTime	固定开始时间	DateTime	否
fixedEndTime	固定结束时间	DateTime	否
arrvialType	到达状态	Integer	是	-1 未到（默认） 0 准时 1 早到 2 晚到
arrvialTime	到达时间	DateTime	副
gmtCreated	创建时间	DateTime	是
gmtModified	修改时间	DateTime	否
version	数据版本	Integer	是	从1开始，每次修改时增1

6）巡检设备 - patrolDevice

版本：1.1

名称	名称	类型	必填	说明
deviceID	设备ID	Integer	是
brand	设备品牌	String(64)	否
model	设备型号	String(64)	否
language	设备语言	String(64)	否
androidVersion	安卓版本	String(64)	否
imei	设备码	String(64)	否
ridUserID	最后登录人员	String(64)	否
loginTime	最后登录时间	DateTime	否
ridDepartmentID	部门	Integer	否
memo	描述	String(512)	否
gmtCreated	创建时间	DateTime	是
gmtModified	修改时间	DateTime	是
version	数据版本，从1开始。每次修改时增1	Integer	是	从1开始。每次修改时增1

7）巡检记录 - patrolLog

版本：1.1

名称	名称	类型	必填	说明
logID	记录ID	Integer	是
ridUserID	人员ID	Integer	是
ridLineID	线路ID	Integer	是
ridNodeID	点位ID	Integer	是
recordTime	巡检时间	DateTime	是
gmtCreated	创建时间	DateTime	是

8）缺陷信息 - patrolDanger

版本：1.0

名称	名称	类型	必填	说明
dangerID	记录ID	Integer	是
ridUserID	人员ID	Integer	是
ridLineID	线路ID	Integer	否
ridNodeID	点位ID	Integer	否
recordTime	上报时间	DateTime	是
picUrl	图片地址	String(256)	否
videoUrl	视频地址	String(256)	否
memo	隐患描述	String(256)	否
proc	是否处理	Boolean	否
procResult	处理结果	String(256)	否
procInfo	处理建议	String(256)	否
procTime	处理时间	DateTime	否
coordinate	坐标点	String(128)	否
gmtCreated	创建时间	DateTime	是

2、接入指南

2.1架构图

综合管控平台通过IoT API网关调数据总线的接口，管理巡更人员、巡更路线、巡更计划，修改巡更缺陷的状态。巡更设备和巡更点通过物模型的方式将GPS位置、巡更事件、缺陷事件上报到物联网平台。

2.2 设备对接

1）电子设备对接物联网平台

对接详情请参考物联网平台接入指南

2）设备数据查询

对接详情请参考设备数据对接指引

2.3 数据对接

对接详情请参考数据模型对接指引