省治超信息系统数据接口说明书V19终稿.docx
《省治超信息系统数据接口说明书V19终稿.docx》由会员分享,可在线阅读,更多相关《省治超信息系统数据接口说明书V19终稿.docx(15页珍藏版)》请在冰豆网上搜索。
省治超信息系统数据接口说明书V19终稿
省治超信息系统
接口说明书
大华信息工程有限公司
2017年6月
文档变更记录
版本号
变更状态
简要说明
变更人
变更日期
1.0
新建
初稿
2017/5/24
1.1
修改
初稿
2017/6/18
1.2
修改
初稿
2017/6/21
1.4
修改
初稿
2017/6/23
1.5
修改
初稿
2017/6/24
1.6
修改
初稿
2017/6/26
1.7
修改
终稿
2017/6/29
1前言
1.1编写目的
此说明书对省治超信息系统向全省各市州、县治超信息系统和超限检测站信息系统提供的数据访问接口进行说明。
1.2命名规范
所有服务名、方法名和参数名采用匈牙利命名规则;
方法名为动名词结构,表示此方法要实现的功能;方法名首字母大写
参数名以类型或类型的简称开头,后面用一到两个单词或者简写表示其大概的含义;
对象名以大写字母开头,对象的属性全部用小写字母。
2省治超中心数据接口
2.1接口连接方法
2.1.1站点基础信息维护
为保证登录用户的合法性和基础信息的真实性,全省各市州、县公路管理机构必须在省治理车辆超限超载信息系统(以下简称“省治超系统”)对本域内的超限检测站信息、不停车检测系统信息、非现场执法点信息进行维护,维护时间为3天,登录时间从首次登录操作本系统开始计算;维护内容包括:
站点名称、站点所属道路名称、站点坐标。
在登录前,申请加入“省治超项目管理QQ群”(群号:
619142728)获取登录用户名、登录密码、登录方法及操作文档。
2.1.2建立VPN账号
在省治超项目管理群中,向系统管理员获取本级VPN账号建立方法,登录账号及密码。
并分别勾选【记住配置】、【自动登录】,按【登录】按钮。
在完成上述两个步骤后,可以访问省治超信息系统的接口地址,实现检测数据的上传。
注:
本次上传的数据应为超限检测站、不停车检测站的实时检测数据。
不支持市级或县级治超信息系统上传的数据。
2.2接口访问地址
http:
//182.168.1.104:
8080/redis/ws/dataWebService?
wsdl
2.3预检信息上传接口
方法名:
saveB_HspinfoList
说明:
预检数据批量上传接口,最多不得超过50条
2.3.1请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
listxml
批量数据xml
string
XML格式参见下文
表21
请求xml格式:
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
...
...
....
...
...
....
2.3.2返回信息
返回值:
boolean成功返回:
true失败返回:
false
2.4低速精检信息上传接口
方法名:
saveB_LscinfoList
说明:
预检数据批量上传接口,最多不得超过50条
2.4.1请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
listxml
批量数据xml
string
XML格式参见下文
表22
请求xml格式:
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
...
...
....
...
...
....
2.4.2返回信息
返回值:
boolean成功返回:
true失败返回:
false
2.5超限执法信息上传接口
方法名:
saveOeinfo
2.5.1请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
listxml
省份代码
string
XML格式参见下文
表23
请求xml格式:
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
...
...
....
...
...
....
2.5.2返回信息
返回值:
boolean成功返回:
true失败返回:
false
3传输对象结构
3.1不停车预检信息Hspinfo
序号
字段名
字段说明
数据类型
长度
备注
1
f_hspid
预检序号
string
36
预检站点编码+6位流水号(必填)
2
f_hsptime
检测时间
datetime
(必填)
格式:
yyyy-mm-ddhh24:
mi:
ss
3
f_stationid
检测站号
string
31
省级分配下发(必填)
4
f_vehicleid
货车牌号
string
31
5
f_vehicletype
货车类型
int
2
6
f_axlesum
轴数
int
2
(必填)
7
f_speed
车速
int
3
(必填)
8
f_laneno
车道
int
2
(必填)
9
f_totalweight
总重
int
6
单位为千克(必填)
10
f_overlimited
超限量
int
6
单位为千克(必填)
11
f_axle1
轴重1
int
6
单位为千克(默认0)
12
f_axle2
轴重2
int
6
单位为千克(默认0)
13
f_axle3
轴重3
int
6
单位为千克(默认0)
14
f_axle4
轴重4
int
6
单位为千克(默认0)
15
f_axle5
轴重5
int
6
单位为千克(默认0)
16
f_axle6
轴重6
int
6
单位为千克(默认0)
17
f_axle7
轴重7
int
6
单位为千克(默认0)
18
f_axle8
轴重8
int
6
单位为千克(默认0)
19
f_offsite
非现场执法标志
string
1
0预检数据(默认0)
1非现场执法
20
f_vehicleimage
预检图片名称
string
50
预检图片名称带后缀(比如xxx.jpg)(必填)
21
f_vehicleimagebase
预检图片
string
图片转换为base64字符串(必填)
22
f_vehicleimage1
预检图片名称1
string
50
预检图片名称带后缀(比如xxx.jpg)(选填)
23
f_vehicleimagebase1
预检图片1
string
图片转换为base64字符串(选填)
24
f_vehicleimage1
预检图片名称2
string
50
预检图片名称带后缀(比如xxx.jpg)(选填)
25
f_vehicleimagebase2
预检图片2
string
图片转换为base64字符串(选填)
3.2超限检测站精检信息Lscinfo
序号
字段名
字段说明
数据类型
长度
备注
1
f_checkno
检测单号
string
36
站点编码+6位流水(必填)
2
f_vehicleid
货车牌号
string
31
(必填)
3
f_axlesum
轴数
int
2
(必填)
4
f_weightlimited
车货限重
int
6
单位为千克
5
f_totalweight
总质量
int
6
单位为千克,行驶证上标明的总质量
6
f_ratedloading
核定载质量
int
6
单位为千克,行驶证上标明的核定载质量
7
f_overlimited
超限量
int
6
单位为千克
8
f_overload
超载量
int
6
单位为千克,实际重量与行驶证标明总质量比较超出部分
9
f_fctime
初检时间
datetime
(必填)
格式:
yyyy-mm-ddhh24:
mi:
ss
10
f_fclaneno
初检车道号
int
2
11
f_fctotalweight
初检总重量
int
6
单位为千克
12
f_fcoper
初检操作员
string
31
13
f_fcaxle1
初检轴重1
int
6
单位为千克
14
f_fcaxle2
初检轴重2
int
6
单位为千克
15
f_fcaxle3
初检轴重3
int
6
单位为千克
16
f_fcaxle4
初检轴重4
int
6
单位为千克
17
f_fcaxle5
初检轴重5
int
6
单位为千克
18
f_fcaxle6
初检轴重6
int
6
单位为千克
19
f_fcaxle7
初检轴重7
int
6
单位为千克
20
f_fcaxle8
初检轴重8
int
6
单位为千克
21
f_fclength
初检车货总长
int
6
单位为毫米
22
f_fcwidth
初检车货总宽
int
6
单位为毫米
23
f_fcheight
初检车货总高
int
6
单位为毫米
24
f_overlength
超长量
int
6
单位为毫米
25
f_overwidth
超宽量
int
6
单位为毫米
26
f_Overheight
超高量
int
6
单位为毫米
27
f_Rctime
复检时间
datetime
Rechecktime,下同
28
f_Rclaneno
复检车道号
int
2
29
f_rctotalweight
复检总重量
int
6
单位为千克
30
f_Rcoper
复检操作员
string
31
31
f_rcaxle1
复检轴重1
int
6
单位为千克
32
f_rcaxle2
复检轴重2
int
6
单位为千克
33
f_rcaxle3
复检轴重3
int
6
单位为千克
34
f_rcaxle4
复检轴重4
int
6
单位为千克
35
f_rcaxle5
复检轴重5
int
6
单位为千克
36
f_rcaxle6
复检轴重6
int
6
单位为千克
37
f_rcaxle7
复检轴重7
int
6
单位为千克
38
f_rcaxle8
复检轴重8
int
6
单位为千克
39
f_Rclength
复检车货总长
int
6
单位为毫米
40
f_Rcwidth
复检车货总宽
int
6
单位为毫米
41
f_Rcheight
复检车货总高
int
6
单位为毫米
42
f_Offload
已卸载量
int
6
单位为千克
43
f_fcvehicleimage
初检车头图片名称
string
图片名称带后缀(比如xxx.jpg)(必填)
44
f_rcvehicleimage
复检车头图片
string
图片名称带后缀(比如xxx.jpg)(必填)
45
f_stationid
检测站号
string
31
f_fcvehicleimagebase
初检车头图片
string
图片转换为base64字符串
f_fcvehicleimagebase1
复检车头图片
string
图片转换为base64字符串
3.3超限执法信息Oeinfo
序号
字段名
字段说明
数据类型
长度
备注
1
f_oeid
执法序号
string
31
OverlimitedenforcementID
2
f_checkno
检测单号
string
31
3
f_bizcertid
道路运输证号
string
63
4
f_carriername
承运人名称
string
255
5
f_carrieraddr
承运人地址
string
255
6
f_carrierpost
承运人邮编
string
6
7
f_lawpersonname
法人代表姓名
string
31
8
f_lawpersonidtype
证件类型
string
1
1-身份证
2-护照
3-其它
9
f_lawpersonid
法人代表证件号码
string
31
10
f_drivername
司机姓名
string
31
11
f_driverid
驾驶证号
string
31
12
f_qualificationid
从业资格证号
string
31
13
f_drivergender
司机性别
string
3
填写“男”或“女”
14
f_driverres
司机户籍
string
63
15
f_cargoname
货物名称
string
127
16
f_cargotype
货物类别
string
4
17
f_cargoownername
货主名称
string
255
18
f_cargolawperson
货主法人代表
string
31
19
f_departure
出发地区
string
255
21
f_destination
目的地区
string
255
22
f_loadingaddr
装货地址
string
255
23
f_punishno
处罚书号
string
31
24
f_punishdate
处罚日期
date
25
f_punishamount
罚款金额
float
12,2
26
f_damageamount
赔偿金额
float
12,2
27
f_enforcername1
执法人1
string
31
28
f_enforcerid1
执法人1证件号码
string
31
29
f_enforcername2
执法人2
string
31
30
f_enforcerid2
执法人2证件号码
string
31
31
f_ismodified
是否非法改装
string
1
0-不是1-是
32
f_modifydesc
非法改装说明
string
127
33
f_isnonstandard
是否非标准车辆
string
1
0-不是1-是
34
f_nonstandarddesc
非标准车辆说明
string
127
35
f_isgreen
是否绿色通道
string
1
0-不是1-是
37
f_notes
备注
string
255