全国机动车缉查布控系统卡口数据上传规范(2013-8-1).doc

全国机动车缉查布控系统 卡口数据上传规范 公安部交通管理科学研究所 二○一三年四月 第一章 概述 卡口数据上传是在卡口系统将卡口车辆通行数据上传机动车缉查布控系统。本规范供有关单位、系统管理员、卡口建设公司参考。 1.1上传信息 一是通行信息文本信息； 二是图片信息，包括特征图片（即号牌图片）与过车图片，其中特征图片必须上传，过车图片可选择上传亦可选择自行保存，在接入通行信息文本信息时上传相应的图片访问路径。 1.2安装部署 安装部署涉及以下几个步骤： 1、安装发布环境的准备 这涉及到服务器和系统软件的准备，需要注意的是卡口数据上传效果不仅与接入服务器有关，还跟数据库服务器、上传服务器等有关，要仔细学习“服务器安装注意要点”。 2、安全接入平台的配置 关键在于确定采用何种网络架构，明确该架构下的配置与服务器准备。 3、接入服务软件安装 1.3接口函数基本说明 序号 函数名称 功能描述 1 InitTrans() 初始化传输连接 2 WriteVehicleInfo() 写车辆信息 3 QuerySyncTime() 时间同步：查询远程服务器时间 4 QueryLimitSpeed() 卡口限速同步：读限速值 5 SaveTzPicture() 写特征图片：以本地文件的方式上传特征图片（号牌图片） 6 SaveTzPicStream() 写特征图片：以二进制流的方式上传特征图片（号牌图片） 7 SavePicture() 写过车图片：以本地文件的方式上传过车图片 8 SavePicStream() 写过车图片：以二进制流的方式上传过车图片 9 GetLastMessage() 获取最新错误信息：获得本次连接最新错误信息，用于调试时上述接口调用报错后找到出错原因。 1、初始连接(InitTrans) 客户端在调用任何的功能函数上传任何车道通行数据之前，须先确保正确调用该函数，以完成该车道（含卡口编号、方向类型、车道号）与上传计算机在接入服务器进行注册的过程，连接成功后会在接入服务器保存该注册。 因此，当接入服务器重新初始化后，客户端都必须重新进行初始化。 返回整形值，具体返回值参考接口说明。 需要特别注意： 如果InitTrans()返回值为零与负数，意味着该设备未被注册，在下次注册尝试时，建议至少10分钟的延时,以减轻后端服务竞用的冲突，提高整个接入系统效率。 每个车道都要执行一次InitTrans，才能够正常上传数据，如非必要不要重复执行。 2、写车辆信息(WriteVehicleInfo) 上传车辆通行信息，客户端需要提供可供外部访问的FTP服务(或http服务)，并确保参数中的远程图片路径参数正确。路径长度应符合要求。 3、时间同步(querySyncTime) 从数据库服务器获取时间，返回格式如：yyyy-mm-dd hh24:mi:ss。 本函数本身并不会自动对客户端设备的系统时间进行调整, 客户端程序需要主动调用该函数实现对本地设备的时钟调整。 本接口所提供时间未计算传输耗时，仅适合网络传输速率较高要求不高的时钟同步情况。 4、限速同步(QueryLimitSpeed) 卡口各车道的限速值由缉查布控系统支队平台集中管理与维护，客户端可根据卡口编号、方向类型、车道号查询对应的车辆行驶限速值。 本函数并不自动更新卡口设备的限速值，客户端程序应主动通过本函数获取中心的车辆限速，更新到的本地，并启用新速度进行超速比对。 为了整个系统的鲁棒性考虑，如果函数返回的限速值为0公里(或小于5公里)，建议使用本地缺省的限速值。这往往意味着中心库没有准确记录限速值。 5、写特征图片(SaveTzPicture、SaveTzPicStream) 上传特征图片（号牌图片），其中SaveTzPicture图片须在上传软件本机磁盘，SaveTzPicStream适用于上传程序获得图片二进制流数据后直接转发以提高上传效率。 注意上传时应与文本信息分开上传，采用多线程（或多进程）。 6、写过车图片(SavePicture、SavePicStream) 上传过车图片，其中SavePicture图片须在上传软件本机磁盘，SavePicStream适用于上传程序获得图片二进制流数据后直接转发以提高上传效率。 注意： （1）卡口备案时图片保存位置（参考2.3节），否则上传图片无法查看。 （2）上传时应与文本信息分开上传，采用多线程（或多进程）。 7、获取最新错误信息(GetLastMessage) 获得本次连接最新错误信息，用于人工调试时，在上述接口调用报错后找到出错原因。在程序自动运行时不要调用该函数，否则将影响上传效率。 1.4接入方式 为适应上传软件不同的开发与运行环