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

全国机动车缉查布控系统卡口数据上传规范公安部交通管理科学研究所二○一三年四月第一章概述卡口数据上传是在卡口系统将卡口车辆通行数据上传机动车缉查布控系统。本规范供有关单位、系统管理员、卡口建设公司参考。1.1上传信息一是通行信息文本信息；二是图片信息，包括特征图片（即号牌图片）与过车图片，其中特征图片必须上传，过车图片可选择上传亦可选择自行保存，在接入通行信息文本信息时上传相应的图片访问路径。1.2安装部署安装部署涉及以下几个步骤：1、安装发布环境的准备这涉及到服务器和系统软件的准备，需要注意的是卡口数据上传效果不仅与接入服务器有关，还跟数据库服务器、上传服务器等有关，要仔细学习“服务器安装注意要点”。2、安全接入平台的配置关键在于确定采用何种网络架构，明确该架构下的配置与服务器准备。3、接入服务软件安装1.3接口函数基本说明序号函数名称功能描述1InitTrans()初始化传输连接：包含登录验证与初始化连接参数的功能，因此在调用功能函数前必须先被调用。2WriteVehicleInfo()写车辆信息：用于传输各种经过车辆的基本信息。3QuerySyncTime()时间同步：查询远程服务器时间，用于设备定时与缉查布控系统数据库服务器时间保持同步。4QueryLimitSpeed()卡口限速同步：读法定限速值，用于卡口主动获取对应地点的机动车辆限速值。5SaveTzPicture()写特征图片：以本地文件的方式上传特征图片（号牌图片）6SaveTzPicStream()写特征图片：以二进制流的方式上传特征图片（号牌图片）7SavePicture()写过车图片：以本地文件的方式上传过车图片8SavePicStream()写过车图片：以二进制流的方式上传过车图片9GetLastMessage()获取最新错误信息：获得本次连接最新错误信息，用于调试时上述接口调用报错后找到出错原因。1、初始连接(InitTrans)客户端在调用任何的功能函数上传任何车道通行数据之前，须先确保正确调用该函数，以完成该车道（含卡口编号、方向类型、车道号）与上传计算机在接入服务器进行注册的过程，连接成功后会在接入服务器保存该注册。因此，当接入服务器重新初始化后，客户端都必须重新进行初始化。返回整形值，具体返回值参考接口说明。需要特别注意：如果InitTrans()返回值为零与负数，意味着该设备未被注册，在下次注册尝试时，建议至少10分钟的延时,以减轻后端服务竞用的冲突，提高整个接入系统效率。每个车道都要执行一次InitTrans，才能够正常上传数据，如非必要不要重复执行。2、写车辆信息(WriteVehicleInfo)上传车辆通行信息，客户端需要提供可供外部访问的FTP服务(或http服务)，并确保参数中的远程图片路径参数正确。路径长度应符合要求。3、时间同步(querySyncTime)从数据库服务器获取时间，返回格式如：yyyy-mm-ddhh24:mi:ss。本函数本身并不会自动对客户端设备的系统时间进行调整,客户端程序需要主动调用该函数实现对本地设备的时钟调整。本接口所提供时间未计算传输耗时，仅适合网络传输速率较高要求不高的时钟同步情况。4、限速同步(QueryLimitSpeed)卡口各车道的限速值由缉查布控系统支队平台集中管理与维护，客户端可根据卡口编号、方向类型、车道号查询对应的车辆行驶限速值。本函数并不自动更新卡口设备的限速值，客户端程序应主动通过本函数获取中心的车辆限速，更新到的本地，并启用新速度进行超速比对。为了整个系统的鲁棒性考虑，如果函数返回的限速值为0公里(或小于5公里)，建议使用本地缺省的限速值。这往往意味着中心库没有准确记录限速值。5、写特征图片(SaveTzPicture、SaveTzPicStream)上传特征图片（号牌图片），其中SaveTzPicture图片须在上传软件本机磁盘，SaveTzPicStream适用于上传程序获得图片二进制流数据后直接转发以提高上传效率。注意上传时应与文本信息分开上传，采用多线程（或多进程）。6、写过车图片(SavePicture、SavePicStream)上传过车图片，其中SavePicture图片须在上传软件本机磁盘，SavePicStream适用于上传程序获得图片二进制流数据后直接转发以提高上传效率。注意：（1）卡口备案时图片保存位置（参考2.3节），否则上传图片无法查看。（2）上传时应与文本信息分开上传，采用多线程（或多进程）。7、获取最新错误信息(GetLastMessage)获得本次连接最新错误信息，用于人工调试时，在上述接口调用报错后找到出错原因。在程序自动运行时不要调用该函数，否则将影响上传效率。1.4接入方式为适应上传软件不同的开发与运行环境（如不同操作系统），提供3种不同的接入方式，分别为传输控件、共享库、Webservice与Servlet三种，其中传输控件、共享库部署在前端（即上传端），由上传软件调用，Webservice与Servlet接口则部署在后端（即接收端）接入服务器。推荐采用传输控件、共享库，以简化与规范上传软件开发，提高数据上传质量与效率。1.4.1控件接入方式在windows操作系统下，上传软件可采用附件所提供的控件（含ActiveX控件和COM组件），按照相关说明接入数据。控件适用开发环境有：Delphi、VisualC++、.net、VisualBasic等，ActiveX用于有界面的上传软件，对于无界面上传软件，可选择COM组件，两者功能与性能上完全一致。1.4.2共享库接入方式上传软件可采取附件所提供的共享库，在linux或者unix操作系统下为.so文件，在windows操作系统下为.dll文件，按照相关说明接入数据。linux、unix下共享库适用于C++的开发环境，是个轻量级的接口，特别适合于嵌入式卡口系统采用。便于从前端一体机直接上传数据与图片，减少中间环节。1.4.3Webservice及Servlet接入方式在不方便使用控件、共享库的情况下，可采用Webservice及Servlet接口接入数据；其中Webservice接口接入文本信息，而Servlet接口主要接入图片等文件。开发环境为java的，比较适合采用这种接入方式。其他能够按照webservice接口生成自动代码的开发工具也可使用。但webservice、servlet接口可能微调，自动生成的代码可能因过于严格而不适用，导致上传软件需要重新编写，因而不推荐该方式。1.5附属文件说明本规范部分相关内容适宜单独说明的及卡口接入相关软件、文件，作为附属文件。序号文件名用途说明1缉查布控系统服务器设置指导机动车缉查布控系统相关服务器安装时为须做的设置2数据接入控件.exe上传控件（包括windows共享库）安装程序3tmriagent.hDLL共享库头文件4前置机安装步骤用于跨安全接入平台指导前置机的安装第二章接入软件的安装部署2.1安装发布环境2.1.1服务器准备按照《机动车缉查布控系统建设指导意见》要求准备接入服务器。卡口接入需要接入服务器与文件服务器，可视情况在不影响正常功能前提下同缉查布控系统其他服务器共用，其中文件服务器要求有满足“建设指导意见”中图片保存期限的足够磁盘空间。当网络架构为严格传统边界时，还需要准备数据库前置机与文件服务前置机（两者可共用）。2.1.2系统软件准备系统管理员须为各服务器安装下列软件：序号服务器要求1接入服务器WebSphere(6.1版本以上)2文件服务器较稳定的Ftp服务器（如FileZillaServer），文件服务与接入服务共用服务器或共享磁盘的，可不必安装。3数据库前置机Oracle数据库（10gR2以上版本）4文件服务前置机较稳定的Ftp服务器（如FileZillaServer），文件服务与接入服务共享磁盘的，可不必安装。2.1.3服务器安装注意要点在服务器准备及软件安装时应注意以下几点，将影响系统未来运行的性能，注意这里的服务器并非只有接入服务器，而是包括系统内所有服务器：（一）服务器基本要求1、要求采用机架式服务器，至少双电源、双网口，不得采用塔式服务器、台式机等替代；2、公安网内服务器应采用IP保护的方式，不要安装一机两用软件；3、操作系统与应用软件（如Oracle、Websphere）应在满足要求的前提下，采用有安装使用经验的成熟版本，不提倡使用新版本；4、应按照《缉查布控系统服务器设置指导》进行额外配置，已尽可能实现长期无人干预下的自动化运行；5、开启远程方式（如windows远程桌面），保证重启后能够依然能够远程；6、各服务器应与统一时钟源进行时钟同步；7、windows服务器应安装病毒防火墙，病毒库升级到最新版。（二）缉查布控系统工作数据库1、数据库服务器应选用所提供服务器中性能最好、磁盘空间足够大的；2、缉查布控系统数据库不得与其他系统共用服务器；3、检查服务器内存，超过4G内存的服务器必须安装64位操作系统，并安装64位的Oracle版本；4、安装Oracle软件须保证，服务器重启后数据库能自动启动，无须人工干预。（三）应用服务器1、应用服务器应采用CPU性能较高、内存较多的服务器，服务器磁盘空间视情况决定，如果需要经过内外网交换平台观看图片的，磁盘空间要求较高否则可较低；2、缉查布控系统应用服务器不得与其他系统共用服务器（视情况可与接入服务器共用）；3、检查服务器内存，超过4G内存的服务器必须安装64位操作系统，并安装64位的Websphere版本；4、要求安装windows操作系统；5、打开文件夹共享服务(netshare)。（四）接入服务器1、接入服务器原则上按照建设指导意见配置，在调试期间可暂时使用性能较低的服务器，需要上传图片的可配置较大的磁盘空间（视需要上传的图片容量决定）；2、接入服务器可与其他系统共用服务器，但须保证websphere中间件能够正常运行；不得在接入服务器上安装开发工具与测试软件；3、检查服务器内存，超过4G内存的服务器必须安装64位操作系统，并安装64位的Websphere版本；4、安装Websphere软件须保证服务器重启后Websphere能自动启动，无须人工干预。（五）前置机1、前置机包含前置接入服务、前置数据库、前置文件服务，可共用一台服务器；2、前置机必须采用性能可靠稳定的服务器，不得采用过于陈旧的服务器；使用之前需要进行检测，保证断电后恢复供电，能够自动正常重启；3、必须保障服务器重启之后，Oracle数据库、Websphere、文件服务均能自动启动；4、检查服务器内存，超过4G内存的服务器必须安装64位操作系统，并安装64位的Oracle、Websphere版本，尽可能采用64位文件服务版本；5、打开文件夹共享服务(netshare)。（六）前端上传服务器1、除了直接部署在嵌入式一体机内的，上传软件须部署在符合“服务器基本要求”的服务器上；不得采用台式机、路面工控机作为上传服务器；2、前端上传服务器可与其他系统共用服务器，但须保证上传软件能够持续稳定运行；3、上传软件在服务器重启后能自动运行；4、服务器有后台保活程序，在上传软件异常退出时能够重启上传软件。2.2安全接入平台的配置2.2.1网络架构根据卡口数据接入公安网的公安内外网接入平台，接入的网络架构分为二类：一、公安内网接入包括由卡口公司或下级平台自行将通行数据接入公安网内再上传的和经批准允许映射方式的的公安网内外网接入（如经批准开放映射方式的严格公安网边界接入平台，使卡口所在网络与公安网之间可以映射等方式进行TCP/IP通讯）。接入服务部署在公安网内。数据流参见如下结构图：接入服务前端卡口前端卡口内外网接入平台外网公安内网缉查布控系统数据库缉查布控系统文件服务器缉查布控系统文本信息...文本信息图片文本信息图片图片二、公安信息通信网边界接入平台根据《公安信息通信网边界接入平台安全规范（试行）》（公信通[2007]191号，2007年10月）建立的边界接入平台，存在以下两种模式：（一）公安机关驻地