全国机动车缉查布控系统卡口数据上传规范.docx
《全国机动车缉查布控系统卡口数据上传规范.docx》由会员分享，可在线阅读，更多相关《全国机动车缉查布控系统卡口数据上传规范.docx（52页珍藏版）》请在冰豆网上搜索。
全国机动车缉查布控系统卡口数据上传规范
全国机动车缉查布控系统
卡口数据上传规范
公安部交通管理科学研究所
二○一三年四月
第一章概述
卡口数据上传是在卡口系统将卡口车辆通行数据上传机动车缉查布控系统。
本规范供有关单位、系统管理员、卡口建设公司参考。
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-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共享库）安装程序
3
tmriagent.h
DLL共享库头文件
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月）建立的边界接入平台，存在以下两种模式：
（一）公安机关驻地外接入模式
专网服务器部署在公安机关有人值守机房，通过认证（公安数字证书）并安装可信边界安全网关客户端，即可通过驻地外接入模式与公安网之间进行TCP/IP通讯（只能单向发起通讯）。
该模式下交换的带宽有限（每秒钟几十M，视边界管理部门的分配情况），如接入卡口数少于300套，可采用文本信息与图片信息均进入公安网的模式，否则建议仅将文本信息接入公安网。
数据流参见如下结构图：
注意要点：
1、协调信通部门批准以公安机关驻地外模式进行卡口数据接入：
（1）接入服务器认证；
（2）接入服务器安装可信边界安全网关客户端；
（二）严格数据交换模式
当卡口接入无法采用公安机关驻地外接入模式时，可采用严格的数据交换模式（社会企/事业接入、公安及党政军接入）。
卡口所在网络与公安网之间TCP/IP通讯不可以直接通讯（包括单向连接），仅能进行数据库记录与文件的交换。
且交换的速度与带宽较为有限，尤其是文件的交换带宽难以满足卡口图片全部实时进入公安网的需要。
因而选择将文本信息以数据库记录的形式、特征图片以文件的形式交换至公安网内，而过车图片保存在外网，在访问的时候交换至公安网。
部署方式：
接入服务部署在外网，接入文本数据保存在数据库前置机上、图片数据保存在文件服务前置机上，然后通过内外网接入平台分别以数据库表、文件两种同步方式接入内网。
两种前置机部署在边界接入平台的前置区，视具体情况可共用服务器。
数据流参见如下结构图：
注意要点：
1、协调信通部门批准以数据库表的形式进行同步，提供四种同步模式：
（1）外网到公安网同步，采用奉献模式（或称剪切模式）；
（2）公安网到外网同步；
（3）外网到公安网同表双向同步；
（4）公安网到专网同表双向同步。
2、协调信通部门，在前置机上安装Oracle数据库（可与其他系统共用）。
3、协调信通部门确定，是否可在前置机安装Websphere（可与其他系统共用），是则接入服务可部署在前置机上，减少服务器配置，否则须在外网另外部署接入服务器，且在前置机安装可靠的ftp文件服务或者将交换目录以共享等方式挂载到接入服务器。
4、协调信通部门确定数据库后置机是否可以设为工作数据库服务器，如果不能，须自行开发工作数据库与后置机交换的功能，而且效率与可靠性存在问题，不建议采用该模式。
2.2.2外网图片访问
图片访问架构主要有图片存储位置（公安网还是外网）决定，当图片存储位置为公安网时，图片访问架构较为简单不再赘述，这里主要讲图片保存在外网的情况。
图片保存在外网主要是由于内外网交换的带宽较低，影响图片访问架构的也主要是公安内外网接入平台，分以下三种：
一、公安机关驻地外接入模式
公安机关驻地外接入方式下，内网应用服务器通过部署于外网的接入服务器进行图片访问，结构图如下：
二、存在视频边界接入平台
视频边界接入平台根据《公安信息通信网边界接入平台安全规范（试行）——视频接入部分》，2011年1月建立，主要用于由公安网访问外网的图片与视频（单向访问）。
对于网络架构为公安信息通信网边界接入平台，并且图片保存在外网的，可通过视频边界改善图片访问效率。
结构图如下：
该模式显著的不同是内网访问不是直接穿透网络访问外网图片服务器，而是通过部署于外网的缉查布控系统接入服务器间接访问外网图片服务器。
以解决不能将所有前端图片服务器认证与安装可信边界安全网关客户端。
注意须协调视频边界管理部门，对缉查布控系统应用服务器与缉查布控系统接入服务器进行认证并安装可信边界安全网关客户端。
三、严格数据交换模式
在即不允许映射，又不存在视频边界，而且不允许直接通讯的严格数据交换模式下，可采用以下结构图提供基本的图片访问：
注意该结构下不仅图片访问延时较大，而且难以支持大量图片并发访问，应限制图片访问。
2.2.3各网络架构下服务器准备
序号
网络架构
服务器
1
公安内网接入
接入服务器（部署于内网）
2
公安机关驻地外接入模式
接入服务器（部署于外网）
3
严格数据交换模式
接入服务器（部署于外网），前置机（数据库与文件服务前置机，可与接入服务器共用服务器）
2.3接入服务软件安装
一、接入服务安装
接口安装由各平台系统管理员按照缉查布控系统安装说明完成。
安装完成后在启动服务前，应根据实际情况修改接入服务发布路径下配置文件：
“/WEB-INF/rminf.properties”。
接入主要涉及以下三项：
1、特征图片接入路径
TZTP_INPUT_PATH
2、过车图片接入路径
TP_INPUT_PATH
网络架构为严格传统边界模式的，还须修改web应用发布路径下配置文件：
“/WEB-INF/rminf.properties”。
1、特征图片访问路径
TZTP_OUTPUT_PATH
2、过车图片访问路径
TP_OUTPUT_PATH
TP_OUTPUT_PATH1~TP_OUTPUT_PATH5
3、过车图片交换路径
TP_TRANS_PATH1~TP_TRANS_PATH5
该项功能为指定图片接入的存储（或暂存）路径，其中“过车图片交换路径”为解决部分边界文件交换不允许子目录的情况，配置过车的临时交换目录，由边界接入平台交换至公安网图片服务器目录，在公安网内须缉查布控系统web程序图片交换功能将图片迁移至最终存储目录，用于访问过车图片时的临时图片交换。
文件服务器路径形如：
ftp\:
//user\:
user666@10.2.44.67/passtrans/
磁盘路径形如：
D\:
\\\\Img
注意由于‘：
’、‘\’在properties文件下为特殊字符，每个之前须加一个‘\’。
否则接入服务无法获取正确路径。
二、接入服务安装
按照《缉查布控系统接入服务安装说明》安装接入服务。
按照《缉查布控系统前置机安装说明》安装前置机（前置机包含接入服务的情况）。
2.4卡口接入工作流程
卡口接入由卡口建设商或维护单位完成，主要工作为采集卡口相关信息，确定网络架构与图片存储方案，开发与调试上传软件等。
系统管理员配合与监督接入工作，完成检查接入质量、保存相关资料等工作。
流程如下：
（一）设计规划
1、确定网络架构
含服务器的安装位置、数据上传的位置等。
该项工作由系统管理员、卡口建设商或维护单位提出方案，咨询信通部门后，由主管领导决定。
2、确定过车图片存储位置
该工作须经系统管理员同意，选择自行保存的，应建立图片服务器（如公安网内能访问，可由前端卡口服务器充当图片服务器），保证所在网络（公安网或专网）内能够通过FTP或者SERVLET方式访问到通行数据对应图片（将路径输入公安网电脑浏览器地址栏，必须能够看到图片），并在上传通行数据时，分别上传图片路径及图片名。
3、确定接入方式
根据卡口情况确定接入方式，向系统管理员获取对应的控件、共享库或者Webservice及SERVLET接入方式访问地址。
文件及安装方式参考3.1。
（二）安装部署接入服务
按照第二章的相关要求，安装部署接入服务与前置机。
（三）卡口备案、参数配置
采集卡口相关信息进行备案：
包括卡口名称（简称）、卡口类型、路段类型、卡口性质、行政区划、道路代码、位置（路口号、道路公里数、米数、经度、维度）、方向（上行别名、下行别名等）、管理部门、使用部门、是否具备特征图片（即号牌图片）等，具体参考缉查布控系统（Web）卡口备案界面：
注意其中的接入位置与过车图片位置：
序号
接入位置
说明
1
公安网
公安内外网接入不采用传统严格边界的所有其他模式。
即过车图片交换至公安网内或在公安网内可以通过链接直接访问的。
2
专网
公安内外网接入采用传统严格边界（参考网络架构第二大类）模式。
即过车图片不交换至公安网且在公安网内无法通过链接直接访问的
序号
过车图片位置
说明
1
缉查布控图片服务器
过车图片上传至缉查布控系统图片服务器，由缉查布控系统管理。
2
非缉查布控图片服务器
过车图片不上传，写车辆信息时提供访问路径，由卡口系统自行管理。
向缉查布控平台系统管理员提交卡口相关信息及过车图片存储位置，进行卡口备案与接口备案，通过审批后，由系统管理员提供以下四类数据：
1、卡口每个车道数据：
序号
名称
说明
1
卡口编号
12位字符串
2
方向类型
1-上行/进城/环线顺时针；2-下行/出城/环线逆时针。
与卡口中的上行、下行方向别名保持对应性。
3
车道号
该车道在道路中的车道顺序号码。
在顺道路方向时，从道路中间隔离带或道路中间划定界开始，从左到右依次为每个行车道所编排的正整数顺序号。
在通行信息上传过程中，车道字段采集的车道号的值。
2、接口备案信息：
序号
名称
说明
1
系统类别
缉查布控系统通行信息接入为62
2
接口ID
形如62C01
3
接口序列号
3、接口地址：
接口地址即接入服务器ip地址与端口号，格式形如10.2.44.178:
9080。
注意透过映射方式（如网闸）接入的，该地址应为网闸在外网映射的IP地址及端口号。
4、缉查布控系统Web临时访问方式
包括地址（形如：
http:
//ip:
port/rmweb）、用户名、密码。
系统管理员应当注意，该用户仅应有机动车轨迹精确查询本地查询的权限。
并在调试结束后收回授权（修改密码）。
（四）数据上传软件开发、测试
1、功能要求
安排技术人员开发上传软件，根据第三章相关说明进行开发与调试。
上传软件除基本功能外，应具有如下要求：
（1）应提供操作手册，尽可能提供源代码，由系统管理员备份。
（2）卡口编号、方向类型、车道号等信息应当可以使用配置文件进行配置，并在操作手册中说明。
（3）断网后或接入服务重启情况下，上传软件应有自动恢复重传功能及漏传通行数据补传功能。
（4）有保活程序，具备自身工作监测和软件异常退出后自动重启功能。
（5）上传服务器重启后，软件具备自动重启功能。
（6）提供控件（或共享库）更新操作方法，并在操作手册中有详细说明。
包括如何暂时关闭上传软件，如何替换控件或共享库，如何重新恢复上传软件。
2、数据与软件质量检查
接入完成须经系统管理员检查：
（1）检查接入数据是否正确
比如是否缺项、代码类数据（如号牌种类）能否正确翻译、相关字段是否匹配、图片链接是否可访问、卡口各车道是否均有数据上传等。
（2）检查上传软件功能要求是否满足
（3）检查数据一致性
选定一个时间段，检查卡口接入数据量与前端卡口数据量一致性。
（4）检查数据上传质量
根据附录接入数据质量指标。
（5）检查上传软件运行稳定性
（6）检查移交的文档与资料
所有文档、资料应当与实际相符。
如按照操作手册可完成所有相关基本操作，且清晰明了。
3、软件安装、培训与移交
安装正式发布版本上传软件，培训相关系统管理员及运维人员，移交操作手册、安装包等资料。
必要的情况下，应移交上传软件的源
升级会员 