智能交通卡口平台据传输接口规范说明 V1.6.docVIP

智能交通卡口平台 数据传输接口规范说明 CY-V 1.6 杭州藏愚科技有限公司 Hangzhou Sharpwisdom Technology Co.Ltd 文件变更记录 变更版本号 日期 修改人 变更摘要 备注 V1.0 2014-07-15 刘世旺 新建 V1.1 2014-08-28 刘世旺 V1.2 2015-03-11 丁慧 修改上传过车方法 V1.3 2015-03-19 程兆玉 修改上传参数说明 V1.4 2015-06-16 程兆玉 增加车牌置信度 增加车牌坐标 V1.5 2015-07-14 程兆玉 修改代码表 V1.6 2015-07-30 吴建 添加校时接口 目录 目录 3 1 适用范围 4 2 术语和定义 4 3 接口总体说明及调用流程 4 3.1 接口函数概要 4 3.2 接口函数返回值说明 4 3.3 接口函数调用流程 5 4 接口函数详细说明 6 4.1 初始化接口 6 4.2 连接关闭 6 4.3 过车记录同步 6 4.4 过车记录参数详细说明 8 5 附录 10 5.1 返回错误代码说明 10 5.2 接入类型码 10 5.3 设备类型表 11 5.4 方向 11 5.5 车道编码 12 5.6 车辆类型编码规则 12 5.7车辆颜色编码规则 13 5.8 号牌颜色编码规则 13 5.9 号牌类型编码规则 13 5.10 车辆品牌代码表 14 1 适用范围 本接口规范适用于卡口设备类型数据采集: 2 术语和定义 下列术语和定义适用于本规范： Web Services 是一种完成其特定需求的在线应用服务，使第三方能够通过 网络来访问并使用这项在线服务。 XML 描述数据的标准方法. SOAP 简单对象访问协议. WSDL Web服务描述语言. 3 接口总体说明及调用流程 本接口采用标准的WEBService框架。 访问路径： http://ip:port/webwssender/webservice/TracklogSender?wsdl 3.1 接口函数概要 函数名 描述 String InitTrans() 初始化传输连接 Void CloseTrans() 关闭传输连接 String WriteTrafficData() 同步方式写过车信息 String getCurrentTime() 获取汇聚的当前时间(返回结果为精确到毫秒的：yyyyMMddHHmmss.SSS格式，用作设备校时) 3.2 接口函数返回值说明 本次接口的返回值全部为字符串类型；返回值采用 “代码（3位字符）＋返回内容”的形式，返回代码与返回内容用“:”符号格开。厂商调用函数完毕，需要判断前3位代码，如果是”000”表示成功，否则表示失败。 返回参数格式： 1、000:内容 ，表示成功, 如：000:添加过车记录成功 2、非000表示失败，如: 001:过车记录字符串为空 3.3 接口函数调用流程 流程简要说明： 1、采集数据上传之前，需要调用 InitTrans()初始化连接，初始化成功后进入下一步，否则重新进行初始化。 2、开始上传过车数据通过writeTracklogData()方法进行上传 ;如果上传成功，则循环上传下一条过车数据。如果中途因连接异常上传不成功，则需要重新初始化。 3、传输任务结束后，需要调用CloseTrans()关闭连接。 4 接口函数详细说明 4.1 初始化接口 String initTrans(string agencyId,string agencyKey) 说明：连接初始化，客户端接入验证。 参数： agencyId,机构编号，唯一标识接入的机构，由服务端分配。机构编号和设备编号唯一标识系统内 的一台设备。 agencyKey，设备密钥,由服务端分配。 返回值：(返回代码^返回内容) “000”， 表示过初始化成功；? 非000值，表示失败。返回结果示例：001: 初始化失败 4.2 连接关闭 void closeTrans(string agencyId,string agencyKey)：连接关闭 说明：关闭传输连接 参数：agencyId 同上 agencyKey同上 4.3 过车记录同步 public String writeTracklogData(String deviceId, String agencyId, String agencyKey, String passport