全部产品
云市场

电子巡更

更新时间:2019-11-22 16:24:50

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 数据对接

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