互联网+停车场库系统数据规范通信接口规范.docx
- 文档编号:28957783
- 上传时间:2023-07-20
- 格式:DOCX
- 页数:29
- 大小:20.35KB
互联网+停车场库系统数据规范通信接口规范.docx
《互联网+停车场库系统数据规范通信接口规范.docx》由会员分享,可在线阅读,更多相关《互联网+停车场库系统数据规范通信接口规范.docx(29页珍藏版)》请在冰豆网上搜索。
互联网+停车场库系统数据规范通信接口规范
附 录 A
(规范性附录)
数据规范
A.1 停车场(库)登记信息
停车场(库)登记信息见表A.1。
表A.1 停车场(库)登记信息表
序号
名称
数据项名称
类型
长度
是否可空
说明
1
停车场编号
TCCBH
字符
24字节
否
参照《广东省公安机关空间标准地址数据结构规范》编码
2
所属行政区号
SSJWQ
字符
15字节
否
所属地区电话号码区号
3
停车场名称
TCCMC
字符
40字节
否
停车场的中文名称
4
停车场位置
TCCWZ
字符
40字节
否
停车场所在位置描述
5
停车位数量
TCWSL
数字
6字节
否
该停车场的规划停车位数量
6
管辖单位名称
DWBH
字符
40字节
否
停车场所属管理单位的名称
7
法人代表姓名
FRDB
字符
30字节
否
法人代表姓名
8
法人代表身份证号码
FRSFZ
字符
18字节
否
标准身份证号码格式
9
法人代表电话号码
FRDH
字符
20字节
否
联系电话,固定电话加区号,手机号码
10
安全管理员姓名
AQGLY
字符
30字节
是
安全管理员姓名
11
安全管理员身份证号码
GLYSFZ
字符
18字节
是
标准身份证号码
12
安全管理员电话号码
GLYDH
字符
20字节
是
联系电话,固定电话加区号,手机号码
13
出口数量
CKSL
数字
2字节
否
数量按一杆一计
14
入口数量
RKSL
数字
2字节
否
数量按一杆一计
15
停车场纬度
TCCWD
字符
14字节
否
设备位置所在地理位置的纬度,按GB/T16831编码和表示法,当纬度的数值小于10、当分或秒的数值小于10时,应在相应的位置补零。
示例:
度、分、秒和十进制两位小数秒,如N119°08'59.05",即北纬119度08分59.05秒
表A.1停车场(库)登记信息表(续)
序号
名称
数据项名称
类型
长度
是否可空
说明
16
停车场经度
TCCJD
字符
14字节
否
设备位置所在地理位置的经度,按GB/T16831编码和表示法,当经度的数值小于100、当分或秒的数值小于10时,应在相应的位置补零。
示例:
度、分、秒和十进制两位小数秒,如E040°52'03.21",即东经40度52分3.21秒
17
停车场状态
TCCZT
字符
1字节
是
0-启用,1-停用,默认为0,用于日后系统维护更新
18
停车场类型
TCCLX
字符
2字节
否
取值:
0其他/1地面/2地下/3立体/4机械/5路边,混合类型的例如:
1(地面)
19
营业时间
YYSJ
字符
18字节
是
非规范格式。
如:
中午11:
00---14:
30
20
收费信息
SFXX
字符
300字节
是
文本表述的收费信息。
如:
前3小时15元/小时,后1小时10元/次
21
停车场限高
TCCXG
字符
5字节
是
停车场限高。
单位:
厘米
22
更新日期
GXSJ
字符
8字节
否
停车场相关登记信息更新的时间,例如收费标准、法人等个别关键字段的更新日期,按照yyyy(年)mm(月)dd(日)格式
A.2 停车场出入控制设备信息
停车场出入控制设备信息见表A.2。
表A.2 停车场出入控制设备信息表
序号
名称
数据项名称
类型
长度
是否可空
说明
1
出入抓拍设备编号
SBBH
字符
20字节
否
停车场出入抓拍设备参照GB/T28181编码要求
2
所属停车场编号
TCCBH
字符
24字节
否
所属停车场编号
3
出入类型
CRLX
字符
1字节
否
出入标识,0出1入
4
设备位置纬度
SBWZWD
字符
14字节
否
设备位置所在地理位置的纬度,按GB/T16831编码和表示法,当纬度的数值小于10、当分或秒的数值小于10时,应在相应的位置补零。
示例:
度、分、秒和十进制两位小数秒,如N119°08'59.05",即北纬119度08分59.05秒
表A.2停车场出入控制设备信息表(续)
序号
名称
数据项名称
类型
长度
是否可空
说明
5
设备位置经度
SBWZJD
字符
14字节
否
设备位置所在地理位置的经度,按GB/T16831编码和表示法,当经度的数值小于100、当分或秒的数值小于10时,应在相应的位置补零。
示例:
度、分、秒和十进制两位小数秒,如E040°52'03.21",即东经40度52分3.21秒
6
出入口所在位置编号
CRKSZWZBH
字符
24字节
否
参照《广东省公安机关空间标准地址数据结构规范》编码
A.3 车辆入停车场(库)数据
车辆入场数据见表A.3。
表A.3 车辆入场数据表
序号
名称
数据项名称
类型
长度
是否可空
说明
1
车辆出场信息编号
RCXXBH
字符
15字节
否
由停车场系统按停车信息服务云平台规则自动生成
2
停车场编号
TCCBH
字符
24字节
否
所属停车场编号
3
停车场管理系统标识号
TCCXTBH
字符
25字节
否
产生该信息的停车场管理系统唯一标识号
4
进入时间
JRSJ
时间
14字节
否
车辆进入停车场的时间,按照yyyy(年)mm(月)dd(日)hh(小时)mm(分)ss(秒)显示,上述时间以24小时计时,月日时分秒均采用两位表示,不足两位时前位补0
5
入口编号
RKBH
字符
2字节
否
停车场出入控制设备信息表对应设备代码
6
进出类型
JCLX
字符
4字节
否
进出类型,如临时、月保
7
号牌号码
HPHM
字符
15字节
否
车辆号牌号码,允许车辆号牌号码不全。
不能自动识别的用“-”表示
8
号牌颜色
HPYS
字符
1字节
否
0—白色,1—黄色,2—蓝色,3—黑色,4—绿色,5-其它颜色
9
图像数量
TXSL
数字
1字节
否
采集的图像数量
10
车辆品牌
CLPP
字符
4字节
是
车辆品牌,非临时车应不可空
表A.3车辆入场数据表(续)
序号
名称
数据项名称
类型
长度
是否可空
说明
11
车辆外型
CLWX
字符
4字节
是
车辆外型,如微型车、小型车、中型车,非临时车应不可空
12
车身颜色
CSYS
字符
5字节
是
车身颜色,非临时车应不可空
13
车辆类型
CLLX
字符
4字节
是
车辆类型,如轿车/载货汽车/客车/挂车,非临时车应不可空
14
预留信息类型
YLXXLX
字符
1字节
否
0—没有,1—流媒体,2—文字
15
预留信息
YLXX
字符
50字节
是
预留的信息(对应YLXXLX)
16
处理标记
CLBJ
字符
1字节
否
0—初始状态未校对,1—已校对和保存,2—无效信息,3—已处理和保存
A.4 车辆出停车场(库)数据
车辆出场数据见表A.4。
表A.4 车辆出场数据表
序号
名称
数据项名称
类型
长度
是否可空
说明
1
车辆出场信息编号
RCXXBH
字符
15字节
否
由停车场系统按停车信息服务云平台规则自动生成
2
停车场编号
TCCBH
字符
24字节
否
所属停车场编号
3
停车场管理系统标识号
TCCXTBH
字符
25字节
否
产生该信息的停车场管理系统唯一标识号
4
入场时间
RCSJ
时间
14字节
否
车辆进入停车场的时间,按照yyyy(年)mm(月)dd(日)hh(小时)mm(分)ss(秒)显示,上述时间以24小时计时,月日时分秒均采用两位表示,不足两位时前位补0
5
出场时间
CCSJ
时间
14字节
否
车辆离开停车场的时间,按照yyyy(年)mm(月)dd(日)hh(小时)mm(分)ss(秒)显示,上述时间以24小时计时,月日时分秒均采用两位表示,不足两位时前位补0
6
停车时长
TCSC
数字
8字节
否
以分钟为单位计算,数据为出场记录时,停车时长不能为空
7
出口编号
CRKBH
字符
2字节
否
停车场出入控制设备信息表对应设备代码
8
进出类型
JCLX
字符
4字节
否
进出类型,如临时、月保
表A.4车辆出场数据表(续)
序号
名称
数据项名称
类型
长度
是否可空
说明
9
号牌号码
HPHM
字符
15字节
否
车辆号牌号码,允许车辆号牌号码不全。
不能自动识别的用“-”表示
10
号牌颜色
HPYS
字符
1字节
否
0—白色,1—黄色,2—蓝色,3—黑色,4—绿色,5-其它颜色
11
图像数量
TXSL
数字
1字节
否
采集的图像数量
12
车辆品牌
CLPP
字符
3字节
是
车辆品牌,非临时车应不可空
13
车辆外型
CLWX
字符
3字节
是
车辆外型,如微型车、小型车、中型车,非临时车应不可空
14
车身颜色
CSYS
字符
5字节
是
车身颜色,非临时车应不可空
15
车辆类型
CLLX
字符
4字节
是
车辆类型,如轿车/载货汽车/客车/挂车,非临时车应不可空
16
预留信息类型
YLXXLX
字符
1字节
否
0—没有,1—流媒体,2—文字
17
预留信息
YLXX
字符
50字节
是
预留的信息(对应YLXXLX)
18
处理标记
CLBJ
字符
1字节
否
0—初始状态未校对,1—已校对和保存,2—无效信息,3—已处理和保存
附 录 B
(规范性附录)
通信接口规范
B.1 停车场基础数据上传接口
接口与协议
a)接口地址:
http:
//[ip]:
[port]/services/rest/uploadParkingInfo
1注:
[ip]为实际使用网络IP或域名,[port]为实际使用端口号,均由停车信息服务云平台提供。
b)接口描述:
请求此接口可上传停车场基础数据信息。
c)响应格式:
JSON
d)请求方式:
POST
e)接口协议:
HTTP
请求参数
a)公共参数是用于标识用户和接口鉴权目的的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。
停车场基础数据上传接口公共参数见表B.1。
表B.1停车场基础数据上传接口公共参数
属性名称
是否可空
类型
说明
secretId
否
String
密钥标识,由停车信息服务云平台提供
signature
否
String
数字签名,用来验证此次请求的合法性
timeStamp
否
String
时间戳值(取值:
推送方服务器Unix当前时间戳,示例:
1473521774)
b)BODY参数值以JSON格式数据填写:
数据内容见表A.1停车场(库)登记信息表。
请求响应结果:
a)响应结果数据为JSON格式数据。
停车场基础数据上传接口响应结果见表B.2。
表B.2停车场基础数据上传接口响应结果
属性名称
是否可空
类型
说明
status
否
String
响应状态(取值:
true、false)
code
否
String
错误代码
msg
否
String
错误信息
data
否
String
响应结果
2注:
true=成功、false=失败
b)结果响应JSON示例:
1——接口请求成功返回示例:
JSON示例:
{"status":
true,"code":
"0000","msg":
"操作成功。
","data":
""}
2——接口请求失败或错误返回示例:
JSON示例:
{"status":
false,"code":
"9999","message":
"未知异常。
","data":
""}
B.2 停车场进场数据上传接口
接口与协议
a)接口地址:
http:
//[ip]:
[port]/services/rest/uploadParkingInData3
3注:
[ip]为实际使用网络IP或域名,[port]为实际使用端口号,均由停车信息服务云平台提供。
b)接口描述:
请求此接口可上传停车场进场数据上接口,要求实时推送。
c)响应格式:
JSON
d)请求方式:
POST
e)接口协议:
HTTP
请求参数
a)公共参数是用于标识用户和接口鉴权目的的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。
停车场进场数据上传接口公共参数见表B.3。
表B.3停车场进场数据上传接口公共参数
属性名称
是否可空
类型
说明
secretId
否
String
密钥标识,由停车信息服务云平台提供
signature
否
String
数字签名,用来验证此次请求的合法性
timeStamp
否
String
时间戳值(取值:
推送方服务器Unix当前时间戳,示例:
1473521774)
b)BODY参数值以JSON格式数据填写。
数据内容见表A.3车辆入场数据表。
请求响应结果:
f)响应结果数据为JSON格式数据。
停车场进场数据上传接口响应结果见表B.4。
表B.4停车场进场数据上传接口响应结果
属性名称
是否可空
类型
说明
status
否
String
响应状态(取值:
true、false)
code
否
String
错误代码
msg
否
String
错误信息
data
否
String
响应结果
4注:
true=成功、false=失败
g)结果响应JSON示例:
3——接口请求成功返回示例:
JSON示例:
{"status":
true,"code":
"0000","msg":
"操作成功。
","data":
""}
4——接口请求失败或错误返回示例:
JSON示例:
{"status":
false,"code":
"9999","message":
"未知异常。
","data":
""}
B.3 停车场出场数据上传接口
接口与协议
a)接口地址:
http:
//[ip]:
[port]/services/rest/uploadParkingOutData
5注:
[ip]为实际使用网络IP或域名,[port]为实际使用端口号,均由停车信息服务云平台提供。
b)接口描述:
请求此接口可上传停车场进出数据上接口,要求实时推送。
c)响应格式:
JSON
d)请求方式:
POST
e)接口协议:
HTTP
请求参数
a)公共参数是用于标识用户和接口鉴权目的的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。
停车场出场数据上传接口公共参数见表B.5。
表B.5停车场出场数据上传接口公共参数
属性名称
是否可空
类型
说明
secretId
否
String
密钥标识,由停车信息服务云平台提供
signature
否
String
数字签名,用来验证此次请求的合法性
timeStamp
否
String
时间戳值(取值:
推送方服务器Unix当前时间戳,示例:
1473521774)
b)BODY参数值以JSON格式数据填写。
数据内容见表A.4车辆出场数据表。
请求响应结果:
a)响应结果数据为JSON格式数据。
停车场出场数据上传接口响应结果见表B.6。
表B.6停车场出场数据上传接口响应结果
属性名称
是否可空
类型
说明
status
否
String
响应状态(取值:
true、false)
code
否
String
错误代码
msg
否
String
错误信息
data
否
String
响应结果
6注:
true=成功、false=失败
b)结果响应JSON示例:
5——接口请求成功返回示例:
JSON示例:
{"status":
true,"code":
"0000","msg":
"操作成功。
","data":
""}
6——接口请求失败或错误返回示例:
JSON示例:
{"status":
false,"code":
"9999","message":
"未知异常。
","data":
""}
B.4 停车场空位数据上传接口
接口与协议
a)接口地址:
http:
//[ip]:
[port]/services/rest/uploadParkingFree
7注:
[ip]为实际使用网络IP或域名,[port]为实际使用端口号,均由停车信息服务云平台提供。
b)接口描述:
请求此接口可上传停车场空位数据上接口,要求每3分钟推送所有停车场的空车位数据。
c)响应格式:
JSON
d)请求方式:
POST
e)接口协议:
HTTP
请求参数
a)公共参数是用于标识用户和接口鉴权目的的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。
停车场空位数据上传接口公共参数见表B.7。
表B.7停车场空位数据上传接口公共参数
属性名称
是否可空
类型
说明
secretId
否
String
密钥标识,由停车信息服务云平台提供
signature
否
String
数字签名,用来验证此次请求的合法性
timeStamp
否
String
时间戳值(取值:
推送方服务器Unix当前时间戳,示例:
1473521774)
b)BODY参数值以JSON格式数据填写。
停车场空位数据上传接口请求参数见表B.8。
表B.8停车场空位数据上传接口请求参数
属性名称
是否可空
类型
说明
id
否
String
停车场id,唯一标识
num_space
否
String
停车场总车位数
num_space_f
否
String
停车场空车位数
请求响应结果
a)响应结果数据为JSON格式数据。
停车场空位数据上传接口响应结果见表B.9。
表B.9停车场空位数据上传接口响应结果
属性名称
是否可空
类型
说明
status
否
String
响应状态(取值:
true、false)
code
否
String
错误代码
msg
否
String
错误信息
data
否
String
响应结果
8注:
true=成功、false=失败
b)结果响应JSON示例:
7——接口请求成功返回示例:
JSON示例:
{"status":
true,"code":
"0000","msg":
"操作成功。
","data":
""}
8——接口请求失败或错误返回示例:
JSON示例:
{"status":
false,"code":
"9999","message":
"未知异常。
","data":
""}
B.5 停车场数据对账
接口与协议
a)接口地址:
http:
//[ip]:
[port]/services/rest/uploadParkingTotal
9注:
[ip]为实际使用网络IP或域名,[port]为实际使用端口号,均由停车信息服务云平台提供。
b)接口描述:
请求此接口可上传停车场前一天数据总量(静态数据和进出数据)。
c)响应格式:
JSON
d)请求方式:
POST
e)接口协议:
HTTP
请求参数
a)公共参数是用于标识用户和接口鉴权目的的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。
停车场数据对账公共参数见表B.10。
表B.10停车场数据对账公共参数
属性名称
是否可空
类型
说明
secretId
否
String
密钥标识,由停车信息服务云平台提供
signature
否
String
数字签名,用来验证此次请求的合法性
timeStamp
否
String
时间戳值(取值:
推送方服务器Unix当前时间戳,示例:
1473521774)
b)BODY参数值以JSON格式数据填写。
停车场数据对账请求参数见表B.11。
表B.11停车场数据对账请求参数
属性名称
是否可空
类型
说明
id
否
String
停车场id
type
否
String
数据类型类型,取值:
0静态数据/1进出数据
date
否
String
时间格式:
YYYY-MM-DD
total
否
String
当天数据量
请求响应结果
a)响应结果数据为JSON格式数据。
停车场数据对账响应结果见表B.12。
表B.12停车场数据对账响应结果
属性名称
是否可空
类型
说明
status
否
String
响应状态(取值:
true、false)
code
否
String
错误代码
msg
否
String
错误信息
data
否
String
响应结果
10注:
true=成功、false=失败
b)结果响应JSON示例:
9——接口请求成功返回示例:
JSON示例:
{"status":
true,"code":
"0000","msg":
"操作成功。
","data":
""}
10——接口请求失败或错误返回示例:
JSON示例:
{"status":
false,"code":
"9999","message":
"未知异常。
","data":
""}
B.6 停车场车辆图片上传
接口与协议
a)接口地址:
http:
//[ip]:
[port]/services/rest/uploadParkingImage
11注:
[ip]为实际使用网络IP或域名,[port]为实际使用端口号,均由停车信息服务云平台提供。
b)接口描述:
请求此接口可上传停车场车辆出入图片。
c)响应格式:
JSON
d)请求方式:
POST
e)接口协议:
HTTP
请求参数
a)公共参数是用于标识用户和接口鉴权目的的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。
停车场车辆图片上传公共参数见表B.13。
表B.13停车场车辆
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 互联网 停车场 系统 数据 规范 通信 接口