目录前言I1范围12规范性引用文件13术语、定义和缩略语14平台接口技术要求25平台性能要求3附录A(规范性附录)数据交换HTTP接口协议5前言本规范是根据交通运输部2013年第49号公告《机动车驾驶员计时培训系统平台技术规范》、《机动车驾驶员计时培训系统计时终端技术规范》以及广州市驾培行业的实际监管要求进行制定.
注:本规范会根据管理部门要求不定时更新,请及时查看.
本规范起草单位:广州军软科技有限公司机动车驾驶员计时培训系统和广州市学驾服务平台监管系统技术规范范围本规范规定了广州市驾驶员培训机构自主建设的机动车驾驶员培训计时平台与管理部门建设的广州市学驾平台监管服务系统的功能要求、平台接口技术要求、平台安全与运行环境要求、数据交换HTTP接口协议和实时传输TCP接口协议要求.
本规范适用于驾驶员培训机构建设、管理和运维计时培训管理系统以及管理部门建设、管理和运维驾驶培训监管服务平台,是机动车驾驶员培训机构开展计时培训及道路运输管理机构实施计时培训管理和服务的基础.
规范性引用文件下列文件对于本文件的应用是必不可少的.
凡是注日期的引用文件,仅所注日期的版本适用于本文件.
凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件.
GB/T2260中华人民共和国行政区划代码GB/T30340机动车驾驶员培训机构资格条件JT/T415-2006道路运输电子政务平台编目编码规则JT/T697.
1-2013交通信息基础数据元-第1部分:总则JT/T808道路运输车辆卫星定位系统终端通讯协议及数据格式中华人民共和国道路运输条例GB/T30340-2013中华人民共和国国家标准(机动车驾驶培训机构资格条件)GB/T30340-2013中华人民共和国国家标准(机动车驾驶培训教练场技术要求)JT/T325-2006中华人民共和国交通行业标准机动车驾驶员培训管理规定(交通部2016年第51号)关于印发机动车驾驶培训教学与考试大纲的通知(交运发2016年第128号)JT/T414-2006道路运政管理信息系统-信息结构体系JT/T415-2006道路运政管理信息系统-编目编码规则《关于做好机动车驾驶人培训考试制度改革工作的通知》(公交管〔2016〕50号)《关于推进机动车驾驶人培训考试制度改革意见的通知》(国办发〔2015〕88号)《关于强制推广应用带有卫星定位功能的汽车行驶记录仪的通知》(粤安监〔2009〕69号)广东省地方标准DB44/T578—2009卫星定位汽车行驶记录仪通用技术规范术语、定义和缩略语术语和定义广州市学驾服务监管平台部署在驾驶培训管理部门,对驾驶培训机构计时培训全过程进行监督和管理,并提供相关信息服务,能够实现与其他信息系统数据共享与交换的平台,简称监管服务平台.
驾驶员培训机构计时培训管理平台部署在机动车驾驶员培训机构或者相关服务企,对学员计时培训全过程进行管理和服务,并为相关管理部门提供信息的平台,以下简称计时平台.
驾驶员培训计时终端部署在机动车驾驶员培训机构,用于采集和记录车辆的位置、速度和运行状态,学员的培训阶段、培训起止时间、培训里程等信息,以及学员和教练员的多媒体信息,并能通过通信网络与计时平台进行信息交互的设备,简称计时终端.
按培训类别不同,分为车载计时计程终端、理论计时终端和模拟计时终端.
数据通信链路异常无线通信链路断开,或暂时挂起(如通话过程中).
未前置注册学员未在学驾平台前置注册.
资料不规范企业提交的资料不符合规范配额不足企业招生配额不足.
缩略语下列缩略语适用于本文件.
TCP—传输控制协议(TransmissionControlProtocol)UDP—用户数据报协议(userdatagrnmprotocol)APN—接入点名称(accesspointname)SMS—短消息服务(shortmessageprotocol)平台接口技术要求计时平台接口技术要求计时平台接口应满足以下技术要求:计时平台非实时数据的交换应采用数据接口或者文件传输等方式实现数据交互,数据至少每天同步1次;数据通信格式应采用XML格式传输,数据传参以字符串方式传递,各数据项之间以"$"符号分隔;数据项中应增加安全码,数据接收后比对安全码进行回调验证.
验证通过后保存数据,不能通过验证则给出失败提示;数据格式应为:数据项1$数据项2$数据项3$……数据项N$安全码;返回信息格式应为:接收结果$结果描述$安全码.
其中接收结果的值为:0-成功;1-失败.
监管服务平台接口要求接口方式基于HTTP协议的RestfulWebservice通信全国驾培平台、监管服务平台、计时平台之间,以及与行业其它业务系统和公安交通管理业务系统之间的数据交换接口应使用HTTP协议,服务端的接口方式应以RestfulWebService方式提供,具体要求见附录A.
通信双方采用JSON格式进行数据传输.
基于TCP协议的Socket通信监管服务平台与计时平台的卫星定位过程明细数据和学时过程明细数据接口应使用基于JT/T808基础扩充的TCP协议,服务端的接口方式应以Socket方式提供,具体要求见附录B.
安全策略全国驾培平台向符合接入条件的监管服务平台、计时平台和计时终端分配唯一标识和安全认证密钥,用于数据交换防篡改和安全认证.
计时终端应能在进入计时培训模式前,向全国驾培平台连线进行密钥验证,通过验证后方可进行培训.
文件存储监管服务平台不提供图片和音视频等文件自动上传存储功能,计时平台应上传图片和音视频文件URL及文件md5,并保证所提供URL的可访问性及安全性.
平台性能要求平台总体性能平台运行应满足以下技术要求:a)支持7*24小时不间断运行;b)在没有外部因素影响下,故障恢复时间不超过2小时;c)平均无故障时间不小于10,000小时.
平台响应时间平台响应时间应至少满足以下要求:a)用户界面查询操作响应不超过8秒;b)用户界面编辑操作相应不超过5秒;c)最大并发用户数达到其系统设计要求时,各事务平均响应时间不应超过单用户平均响应时间的五倍.
网络传输环境网络传输环境应满足以下要求:计时平台应支持互联网或互联网VPN连接监管服务平台,监管服务平台应支持专线网络或互联网VPN连接全国驾培平台;计时平台应采用多层缓存机制,采用双网双线访问策略控制.
数据要求数据采集和记录应满足以下要求:计时平台采样卫星定位数据时间间隔不得大于30秒;学时记录以分钟为单位,里程记录以公里为单位;图片尺寸应不小于320*240像素,格式为JPEG,图片文件应不小于10KB;视频最小帧数为3帧,分辨率最小为cif.
数据存储及备份数据存储及备份应满足以下要求:计时平台数据存储(包括:学员基本信息、培训基本信息和培训过程信息等)时间应不少于4年,且应在学员获得驾驶证后至少保存3年.
监管服务平台的培训档案数据存储时间,不得少于3年;应建立数据备份机制,每月对数据进行全量备份,每周对数据进行增量备份.
数据恢复时间不超过5小时.
平台安全要求平台应满足以下安全要求:数据库中关键数据应加密存储,用户密码加密存储;采用日志对操作、接收及发送的数据进行记录,日志至少存储6个月;采用双机热备份,主平台出现故障时能够自动切换到备份平台;平台间数据交换采用加密传输方式.
运行环境要求平台应满足以下运行环境要求:a)数据库服务器支持大数据量存储与检索;b)局域网网络交换速度不低于100Mbps.
(规范性附录)数据交换HTTP接口协议数据格式及约束条件数据格式见JT/T697.
1—2013中5.
15.
所有的请求和应答报文均采用JSON格式.
约束条件见表A.
1.
约束条件符号约束条件0.
.
1,可选项*0.
.
n,可以没有,也可以有多项+1.
.
n,至少有1项,也可以有多项1必须且只能填1项F固定长度V可变长度接口通用应答接口通用应答字段名称层级类型取值默认值意义备注errorcode1.
1int详见附录A.
3错误码定义0错误码message1.
2stringnull提示信息data1.
3objectnull附加信息错误码定义错误码定义错误码意义备注0执行成功/数据上传成功1执行失败100请求的服务/资源不存在200数据格式错误,无法正确解析统一编号规则学时记录编号:XXXXXX(行政代码)XXXX(运营商序列号)XXXXXX(计时设备序列号)XXXXXX(年月日YYMMDD)XXXX(自增流水号)课程编码:X(阶段:1、2、3)X(实操1,理论集中学习2,模拟3,远程教学4)XX(一级课程)XX(二级课程)XX(三级课程)XX(四级课程)文件资料信息接口业务描述:资料文件上传,支持JPG/JPEG、PNG、PDF等不同类型的文件.
不同的接口需要上传的信息中含有多媒体、PDF等资料文件时,应先使用本接口上传资料文件,从应答中获得文件的ID,然后再使用相应的业务数据接口并将获得的文件ID和其他信息一起上传.
接口定义见表A.
4:文件资料信息上传接口定义服务名ImageupURL/imageup/{type}v={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域Type:文件业务类型{stuimg:学员头像;stufp:学员指纹;coachimg:教练员头像;coachfp:教练员指纹;examinerimg:考核员头像;examinerfp:考核员指纹;securityguardimg:安全员头像;securityguardfg:安全员指纹;vehimg:教练车图片;outletsimg:招生点照片;occupationimg:资格证书图片;voiceprintimg:声纹文件;epdfimg:电子培训部分记录表PDF文件;onlineimg:网络远程学习过程照片;classroom:课堂教学过程照片;simulation:模拟教学过程照片;video:视频文件}备注应答报文格式见表A.
5:文件资料信息上传应答报文格式序号元素名称必选类型长度字段名称描述及要求1errorcode是数值型V16返回码2message是字符型V128提示信息3data是对象附加信息4id是数值型V16成功上传的文件ID平台间数据传输接口培训机构信息培训机构信息接口备案培训机构接口业务描述:用于计时平台向广州市学驾服务平台备案培训机构信息.
接口定义见表A.
6:备案培训机构接口定义服务名InstitutionURL/institutionv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
7:备案培训机构请求报文格式序号元素名称必选类型长度字段名称描述及要求1district是字符型F6区县行政区划代码见GB/T22602name是字符型V256培训机构名称填写名称全称3shortname是字符型V128培训机构简称填写简称4licnum是字符型F12经营许可证编号5licetime是字符型V64经营许可日期YYYYMMDD6business是字符型F20营业执照注册号7creditcode否字符型F18统一社会信用代码8address是字符型V512培训机构地址9postcode是字符型F6邮政编码10legal是字符型V64法人代表11contact是字符型V64联系人12phone是字符型V32联系电话13busiscope是字符型V8经营范围下列编码可多选,以英文逗号分隔:A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P14busistatus是字符型V8经营状态经营状态定义如下:1:营业2:停业3:整改4:停业整顿5:歇业6:注销9:其他15level是字符型V8分类等级1:一级2:二级3:三级16coachnumber是数值型V16教练员总数17grasupvnum是数值型V16考核员总数18safmngnum是数值型V16安全员总数19tracarnum是数值型V16教练车总数20classroom否数值型V16教室总面积单位:m221thclassroom否数值型V16理论教室面积单位:m222praticefield是数值型V16教练场总面积单位:m223roadallowcert是字符型F12道路经营许可证24passdept是字符型V32批准机关25cardvilidity是字符型V10证件有效期YYYYMMDD26prvdcarddate是字符型V10发证日期YYYYMMDD27trainvhcltype是字符型F8培训车型可多选,以英文逗号分隔:A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P28corptype是字符型F2企业类型单选:1:普通机动车驾驶员培训2:道路运输从业资格培训3:机动车驾驶员培训训练场4:机动车驾驶员培训教练场经营5:普通合伙29opendate是字符型V10开业日期YYYYMMDD应答报文格式如下表:备案培训机构应答报文格式序号层级元素名称约束类型长度描述取值说明11.
1errorcode1数值型V16错误码21.
2message1字符型V128提示信息31.
3data1对象附加信息41.
3.
1inscode1字符型V128培训机构编号统一编号教练员信息接口备案教练员业务描述:用于计时平台向广州市学驾服务平台备案教练员信息.
图片文件ID应先使用A5.
3文件资料信息接口成功上传图片后获得.
接口定义见表A.
9:备案教练员接口定义服务名CoachURL/coachv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
10:备案教练员请求报文格式序号元素名称必选类型长度字段名称描述及要求1inscode是字符型F16培训机构编号统一编号2name是字符型V64姓名3sex是数值型V4性别1:男性;2:女性4idcard是字符型V128身份证号5mobile是字符型V32手机号码6address否字符型V256联系地址7photo是数值型V16照片文件ID成功上传的教练员头像文件ID8fingerprint否数值型V16指纹图片ID成功上传的指纹图片ID9drilicence是字符型V128驾驶证号10fstdrilicdate是字符型V64驾驶证初领日期YYYYMMDD11occupationno否字符型V128职业资格证号12occupationlevel否字符型V8职业资格等级1:一级2:二级3:三级4:四级13dripermitted是字符型V8准驾车型下列编码单选:A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P14teachpermitted是字符型V8准教车型下列编码单选:A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P15employstatus是字符型V4供职状态0:在职1:离职16hiredate是字符型V64入职日期YYYYMMDD17leavedate否字符型V64离职日期YYYYMMDD18birthdate是字符型V64出生日期YYYYMMDD19position是字符型F1岗位可多选:1:理论教练员2:实操教练员20educationlevel是字符型F2学历单选:1:博士,2:硕士,3:本科生,4:大专,5:中专,6:高中,7:初中21coachcert否字符型V32教练员证号应答报文格式如下表:备案教练员接口应答报文格式序号层级元素名称约束类型长度描述取值说明11.
1errorcode1数值型V16错误码21.
2message1字符型V128提示信息31.
3data1对象附加信息41.
3.
1coachnum1字符型V128教练员编号统一编号教练车信息接口备案及修改教练车业务描述:用于计时平台向广州市学驾服务平台备案教练车信息.
图片文件ID应先使用A5.
3文件资料信息接口成功上传图片后获得.
接口定义见表A.
12:备案教练车接口定义服务名TrainingCarURL/trainingcarv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
13:备案教练车请求报文格式序号元素名称必选类型长度字段名称描述及要求1inscode是字符型F16驾培编号统一编号2franum否字符型V32车架号3engnum否字符型V32发动机号4licnum是字符型V64车牌号5platecolor是字符型V64车牌颜色1:蓝色2:黄色3:黑色4:白色5:绿色9:其他6photo是否数值型V16图片成功上传的教练车照片文件ID7manufacture是字符型V256生产厂家如"上汽大众"8brand是字符型V256车辆品牌如"桑塔纳"9model否字符型V128教学车型如"普通桑塔纳"、"桑塔纳2000"10perdritype是字符型V8培训车型下列编码单选:A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P11buydate是字符型V64购买日期YYYYMMDD12coachvehicleid是字符型V32教练车凭证号13loadseat是数值型F2载客量14factorymodel是字符型V16厂牌型号应答报文格式如下表:备案教练车接口应答报文格式序号层级元素名称约束类型长度描述取值说明11.
1errorcode1数值型V16错误码21.
2message1字符型V128提示信息31.
3data1对象附加信息41.
3.
1carnum1字符型V128教练车编号统一编号培训机构教学区域备案教学区域接口业务描述:用于计时平台向广州市学驾服务平台备案培训机构教学区域信息.
接口定义见表A.
15:备案教学区域接口服务名RegionURL/regionv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
16:备案教学区域请求报文格式序号元素名称必选类型长度字段名称描述及要求1inscode是字符型F16培训机构编号统一编号2seq是字符型V4教学区域编号计时平台顺序编号3name否字符型V256教学区域名称4address是字符型V256教学区域地址5area是数值型V6教学区域面积单位:m26type是数值型V2教学区域类型1:第二部分;2:第三部分7vehicletype是字符型V256培训车型下列编码可多选,以英文逗号分隔A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P8polygon是字符型V1024多边形坐标序列经度1,纬度1;经度2,纬度2;经度3,纬度3;……9totalvehnum否数值型V6可容纳车辆数10curvehnum否数值型V6已投放车辆数应答报文格式:通用应答.
计时终端信息接口备案计时终端业务描述:用于计时平台向广州市学驾服务平台备案计时终端信息.
接口定义见表A.
17:备案计时终端接口定义服务名DeviceURL/devicev={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
18:备案计时终端请求报文格式序号元素名称必选类型长度字段名称描述及要求1termtype是数值型V4计时终端类型1:车载计程计时终端2:课堂教学计时终端3:模拟训练计时终端2vender是字符串V128生产厂家3model是字符串V128终端型号4imei是字符型V128终端IMEI号或设备MAC地址5sn是字符型V128终端出厂序列号6inscode是字符型F16培训机构编号统一编号,课堂教学和模拟训练计时终端应上传应答报文格式如下表:备案计时终端接口应答报文格式序号元素名称约束类型长度描述取值说明1errorcode是数值型V128错误码2message是字符型V128提示信息3data是对象附加信息4devnum是字符型V128终端编号统一编号5key是字符型V4096终端证书6passwd是字符型V12终端证书口令车载计程计时终端绑定接口业务描述:用于计时平台在车载计程计时终端安装后,向广州市学驾服务平台上传计时终端绑定教练车信息并进行备案.
接口定义见表A.
20:车载计程计时终端绑定接口定义服务名DevassignURL/devassignv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
21:车载计程计时终端绑定请求报文格式序号元素名称必选类型长度字段名称描述及要求1devnum是字符型F16终端编号统一编号2carnum是字符型F16车辆编号统一编号3sim是字符型V16终端SIM卡号应答报文格式:通用应答.
车载计程计时终端解绑接口业务描述:用于车载计程计时终端拆除或更换后,向广州市学驾服务平台上传计时终端解除绑定教练车信息并进行备案.
接口定义见表A.
22:车载计程计时终端解绑接口定义服务名DevRembindingURL/devRembindingv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
23:车载计程计时终端解绑请求报文格式序号元素名称必选类型长度字段名称描述及要求1devnum是字符型F16终端编号统一编号2carnum是字符型F16车辆编号统一编号3sim是字符型V16终端SIM卡号应答报文格式:通用应答.
学员培训过程信息学员信息接口备案学员信息业务描述:用于计时平台向广州市学驾服务平台备案学员信息.
接口定义见表A.
24:备案及修改学员接口定义服务名StudentURL/studentv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
25:备案及修改学员请求报文格式序号元素名称必选类型长度字段名称描述及要求1inscode是字符型F16培训机构编号统一编号2stunum否字符型F16学员编号新增不传修改必传3cardtype是字符型V4证件类型1:身份证2:护照3:军官证4:其他4idcard是字符型V128证件号5nationality是字符型V128国籍6name是字符型V64姓名7sex是字符型V4性别1:男性;2:女性8phone是字符型V32移动号码9address否字符型V256邮寄地址10photo是数值型V16照片文件ID成功上传的学员头像照片文件ID11fingerprint否数值型V16指纹图片ID12busitype是字符型V4业务类型0:初领1:增领9:其他13drilicnum否字符型V128驾驶证号14fstdrilicdate否字符型V64驾驶证初领日期YYYYMMDD15perdritype否字符型V8原准驾车型下列编码单选:A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P16traintype是字符型V8申请车型下列编码单选:A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P17applydate是字符型V64报名时间YYYYMMDD18registercode是字符型V16注册码19birthdate是字符型V64出生日期20cardtype2否字符型V4证件类型21:身份证2:护照3:军官证4:其他21idcard2否字符型V128证件号222postcode否字符型V6邮政编号23cardaddress否字符型V256证件地址24telephone否字符型V32固定电话25applyfrom否字符型V128申请来源1:本地,2:外地,3:外籍4:转入,5:军警,6:香港7:澳门,8:台湾,9:使领馆10:农机26applyaddress否字符型V128报名地点27contractnum否字符型V16协议编号28practicecoach否字符型V32实操教练29platenum否字符型V16车牌号30recruitprice否数值型F8招生价格31recordprice否数值型F8备案价格32ispoor是字符型V1是否贫困生1是0不是33istimer是字符型V1是否计时培训学员1是0不是34areacode是字符型V6证件地区号35areacode2否字符型V6联系地址区号36distinguishcolor否字符型V1辨色力1合格0不合格37upperlimb否字符型V1上肢1合格0不合格38leftlowerlimb否字符型V1左下肢1合格0不合格39rightlowerlimb否字符型V1右下肢1合格0不合格40trunkneck否字符型V1躯干颈部1合格0不合格41hearing否字符型V1听力1合格0不合格42height否数值型V1身高(cm)43checkdate否字符型V64体检日期YYYYMMDD44leftsight否字符型V8左视力45rightsight否字符型V8右视力46hospital否字符型V128体检医院47idphysicscard否字符型V32身份证物理卡号应答报文格式见表A.
26:学员备案应答报文格式序号元素名称必选类型长度字段名称描述及要求1errorcode是数值型V16返回码2message是字符型V128提示信息3data是对象附加信息4stunum是字符型F16学员编号统一编号(新增时返回)电子教学日志接口业务描述:用于计时平台或远程教育平台向广州市学驾服务平台上传学员学时信息进行备案.
实车教学的照片不必使用A5.
3文件资料信息接口上传,其图片ID采用计时终端编号+TCP协议中转发的照片编号.
图片文件ID应先使用A5.
3文件资料信息接口成功上传图片后获得.
接口定义见表A.
27:培训学时接口定义服务名ClassRecordURL/classrecordv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
28:培训学时接口请求报文格式序号元素名称必选类型长度字段名称描述及要求1inscode是字符型F16培训机构编号统一编号2stunum是字符型F16学员编号统一编号3coachnum是字符型F16教练员编号统一编号,远程教育平台不使用4carnum是字符型F16教练车编号统一编号,远程教育平台不使用5simunum是字符型F16计时终端编号统一编号,远程教育平台不使用6platnum是字符型F5平台编号计时平台或远程教育平台编号7recnum是字符型F5电子教学日志编号平台自主编号8subjcode是字符型F10课程编码见A4.
29photo1是字符型V32签到照片相片文件1ID10photo2否字符型V32随机照片相片文件2ID,从每15分钟拍摄的照片中随机选一张,超过15分钟的教学必选11photo3是字符型V32签退照片相片文件3ID12starttime是字符型V64培训开始时间YYYYMMDDHHmmss13endtime是字符型V64培训结束时间YYYYMMDDHHmmss14duration是字符型V64培训学时单位:min15mileage是数值型V16培训里程单位:km,非实操时为016avevelocity是数值型V16培训平均速度单位:km/h,非实操时为017coacmt否字符型V64教练员点评18total是数值型V6总累计学时单位:min19part1是数值型V6第一部分累计学时单位:min20part2是数值型V6第二部分累计学时单位:min21part3是数值型V6第三部分累计学时单位:min22part4是数值型V6第四部分累计学时单位:min23trainid是数值型V10课堂ID标识学员的一次培训过程,计时平台自行使用应答报文格式:通用应答.
学时信息接口阶段培训记录信息接口业务描述:用于计时平台或远程教育平台向广州市学驾服务平台上传阶段培训记录信息和电子培训部分记录表进行审核,电子培训部分记录表PDF文件ID应先使用A5.
3文件资料信息接口成功上传文件后获得.
再次提交同一学员同一培训部分的阶段培训记录时,应仅提交本次新补充的学时记录.
接口定义见表A.
29:阶段培训记录接口定义服务名StageTrainningTimeURL/stagetrainningtimev={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
30:阶段培训记录请求报文格式序号元素名称必选类型长度字段名称描述及要求1inscode是字符型F16培训机构编号统一编号2stunum是字符型F16学员编号统一编号3subject是数值型V8培训部分1:第一部分;2:第二部分;3:第三部分;4:第四部分4totaltime是数值型V6培训部分总学时单位:分钟,本培训部分实际完成的总学时,学员主动要求以及由于考核或考试不合格增加的学时也应上报5vehicletime是数值型V6实车教学学时单位:分钟,本培训部分实际完成的实车教学学时,第一、四部分时为06classtime是数值型V6课堂教学学时单位:分钟,本培训部分实际完成的课堂教学学时,第二、三部分时为07simulatortime是数值型V6模拟器教学学时单位:分钟,本培训部分实际完成的模拟器教学学时,第一、四部分时为08networktime是数值型V6远程教学学时单位:分钟,本培训部分实际完成的远程教学学时,第二、三部分时为09duration是数值型V6培训学时单位:分钟,本次上报本培训部分的初审总学时10examresult是数值型V4考核结果0:未考核;1:合格;2:不合格11mileage否数值型V6培训里程非第三部分时可置"0"12pdfid否数值型V16电子培训部分记录表PDF文件ID计时平台应使用13esignature是字符型V1024培训机构电子签章数据14rectype是数值型V4学时组成1:实车教学;2:课堂教学;3:模拟器教学;4:远程教学;5:混合15recarray是数组学时记录编号数组实车教学时使用计时终端通过TCP协议上传的学时记录编号;课堂教学、模拟器教学、网络远程教学时使用学员编号+电子教学日志编号16rnum是字符型F26第1个学时记录编号……17rnum是字符型F26第n个学时记录编号应答报文格式:通用应答.
教练车进出场接口业务描述:用于计时平台备案在教学区域进出场的教练车登记信息.
接口定义见表A.
31:教练车进出场接口定义服务名VehicleRecordURL/vehiclerecordv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
32:教练车进出场接口请求报文格式序号元素名称必选类型长度字段名称描述及要求1inscode是字符型F16培训机构编号统一编号2seq是字符型V8教学区域编号3platenum是字符型F16车牌号6starttime是字符型V20进场时间YYYYMMDDHHmmss7endtime是字符型V64出场时间YYYYMMDDHHmmss应答报文格式:通用应答.
平台间数据通知接口消息通知审核结果消息通知接口业务描述:由计时平台或远程教育平台提供,用于监管平台在审核完成后向计时平台或远程教育平台发送消息通知,计时平台根据审核类型调用相应的审核结果查询接口.
对远程教育平台的阶段培训记录审核结果,监管平台应分别通知计时平台和远程教育平台.
接口定义见表A.
33:审核结果消息通知接口定义服务名ReviewmsgURL/reviewmsgv={version}&ts={timestamp}&sign={sign_str}&user={cert_sn}HTTP方法POST参数/表域备注请求报文格式见表A.
34:审核结果消息通知请求报文格式序号元素名称必选类型长度字段名称描述及要求1reviewtype是字符型V4审核结果通知类型3:电子教学日志4:教学区域;2data是对象审核结果参数见表A.
35、表A.
36审核结果消息通知内容-教学区域审核结果参数报文格式序号元素名称必选类型长度字段名称描述及要求1inscode是字符型F16培训机构编号统一编号2seq是字符型V4教学区域编号计时平台顺序编号3name否字符型V256教学区域名称4address是字符型V256教学区域地址5area是数值型V6教学区域面积单位:m26type是数值型V2教学区域类型1:第二部分;2:第三部分7vehicletype是字符型V256培训车型下列编码可多选,以英文逗号分隔A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P8polygon是字符型V1024多边形坐标序列经度1,纬度1;经度2,纬度2;经度3,纬度3;……9totalvehnum否数值型V6可容纳车辆数10curvehnum否数值型V6已投放车辆数11state是数值型V6状态0:停用,1:启用审核结果消息通知内容-电子教学日志审核结果参数报文格式序号元素名称必选类型长度字段名称描述及要求1inscode是字符型F16培训机构编号统一编号2stunum是字符型F16学员编号统一编号3recnum是字符型F5电子教学日志编号平台自主编号4subject是数值型V8培训部分1:第一部分;2:第二部分;3:第三部分;4:第四部分5duration是数值型V6审核合格学时本培训部分本次的审核合格总学时,单位min6trainid是数值型V10课堂ID标识学员的一次培训过程,计时平台自行使用应答报文格式:通用应答.
(规范性附录)实时传输TCP接口协议概述本附录规定了计时终端与计时平台、计时平台或远程教育平台与监管服务平台以及监管服务平台与全国驾培平台之间的实时传输通信协议与数据格式,包括协议基础、通信连接、消息处理、协议分类与说明及数据格式.
协议基础通信方式协议采用的通信方式应符合JT/T808中的相关规定,通信协议可采用TCP或UDP.
用于计时终端与计时平台通信时,平台作为服务器端,终端作为客户端,当数据通信链路异常时,终端可以采用SMS消息方式进行通信.
用于计时平台或远程教育平台与监管服务平台之间的通信时,监管服务平台作为服务器端,计时平台或远程教育平台作为客户端.
用于监管服务平台与全国驾培平台之间的通信时,全国驾培平台作为服务器端,监管服务平台作为客户端.
数据类型协议消息中使用的数据类型见表B.
1.
数据类型数据类型描述及要求BYTE无符号单字节整型(字节,8位)WORD无符号双字节整型(字,16位)DWORD无符号四字节整型(双字,32位)BYTE[n]n字节BCD[n]8421码,n字节STRINGGBK编码,采用0终结符,若无数据,则放一个0终结符传输规则协议采用大端模式(big-endian)的网络字节序来传递字和双字.
约定如下:——字节(BYTE)的传输约定:按照字节流的方式传输;——字(WORD)的传输约定:先传递高八位,再传递低八位;——双字(DWORD)的传输约定:先传递高24位,然后传递高16位,再传递高八位,最后传递低八位.
消息的组成消息结构每条消息由标识位、消息头、消息体和校验码组成,消息结构表见表B.
2.
消息结构表标识位消息头消息体校验码标识位标识位采用Ox7e表示,若校验码、消息头以及消息体中出现0x7e,则要进行转义处理,转义规则定义如下:0x7e0x7d后紧跟一个0x02;0x7d0x7d后紧跟一个0x01.
转义处理过程如下:发送消息时:消息封装——>计算并填充校验码——>转义;接收消息时:转义还原——>验证校验码——>解析消息.
示例:发送一包内容为0x300x7e0x080x7d0x55的数据包,则经过封装如下:0x7e0x307d0x020x080x7d0x010x550x7e.
消息头消息头内容详见表B.
3.
消息头内容起始字节字段数据类型描述及要求0协议版本号BYTE协议标准的版本号,具体定义如下:0:JT/T808-2011;1:北斗兼容车载终端通讯协议技术规范-2013;128:机动车驾驶员计时培训系统平台技术规范-2016;224-255:自定义;其他保留1消息IDWORD3消息体属性WORD消息体属性格式结构图见表B.
45终端手机号BCD[8]根据安装后终端自身的手机号转换.
手机号不足16位,则在前补充数字,大陆手机号补充数字0港澳台则根据其区号进行位数补充.
平台自身的业务消息使用自己的平台编号,前补0x00.
13消息流水号WORD按发送顺序从0开始循环累加15预留BYTE预留16消息包封装项如果消息体属性中相关标识位确定消息分包处理,则该项有内容,否则无该项消息体消息体属性格式消息体属性格式结构表见表B.
4.
消息体属性格式结构表1514131211109876543210保留分包数据加密方式消息体长度数据加密方式数据加密方式定义如下:——bit10-bit12为数据加密标识位;——当此三位都为0时,表示消息体不加密;——仅当第10位为1时,表示消息体经过RSA算法加密;——其他保留.
分包当消息体属性中第13位为1时表示消息体为长消息,进行分包发送处理,具体分包信息由消息包封装项决定;若第13位为0,则消息头中无消息包封装项字段.
消息包封装项内容见表B.
5.
消息包封装内容起始字节字段数据类型描述及要求0消息总包数WORD该消息分包后的总包数2包序号WORD从1开始校验码校验码指从消息头开始,同后一字节异或,直到校验码前一个字节,占用一个字节.
通信连接连接的建立用于计时终端与计时平台通信时,数据日常连接可采用TCP或UDP方式.
用于计时平台或远程教育平台与监管服务平台、监管服务平台与全国驾培平台之间的通信时,数据日常连接应采用TCP协议长连接方式.
客户端复位后应尽快与服务器端建立连接,连接建立后计时终端客户端使用终端鉴权消息进行鉴权,平台客户端使用平台登录请求消息进行登录.
连接的维持连接建立和客户端鉴权成功后,在没有正常业务数据包传输的情况下,客户端应周期性向服务器端发送客户端心跳消息,服务器端收到后向客户端发送服务器端通用应答消息,发送周期由客户端参数指定.
连接的断开服务器端和客户端均可根据TCP协议主动断开连接,双方都应主动判断TCP连接是否断开.
服务器端判断TCP连接断开的方法:——收到客户端的登出请求消息;——根据TCP协议判断出客户端主动断开;——相同身份的客户端建立新连接,表明原连接已断开;——在一定的时间内未收到客户端发出的消息.
客户端判断TCP连接断开的方法:——根据TCP协议判断出服务器端主动断开;——数据通信链路断开;——数据通信链路正常,达到重传次数后仍未收到应答.
分包消息消息的分包应在基本消息和扩展消息消息体组包全部完成后进行,按照每个分包的大小进行切包,不足一个分包大小的剩余数据放在最后一个分包中.
分包完成后再根据分包内容生成相对应的消息头,计算校验码,再进行转义处理.
消息采用分包发送时,其分包消息应采用连续递增的流水号.
对分包消息的应答,如果没有专门的应答指令,则接收方应对每条分包消息采用一条通用应答,并使用结果字段(成功/失败)告知发送方是否正确收到所有的分包消息.
在未正确收到所有的分包消息时,接收方可采用补传分包请求命令要求发送方重传缺失的分包消息.
发送方应采用原始消息将重传包ID列表中的分包重发一次,重传分包与原始分包消息完全一致.
转发消息计时平台在收到计时终端上传的部分消息时,应首先应答终端,然后将终端上传的消息不做任何修改直接转发到监管服务平台.
对所有转发的终端消息,监管服务平台回复服务器端通用应答.
计时平台应转发的终端消息包括:终端注册、终端注销、终端鉴权、位置汇报、教练员登录、教练员登出、学员登录、学员登出、上报学时记录、照片上传初始化、上传照片数据包,以及对补传分包请求消息的应答分包消息,转发终端消息只在该业务成功时进行,失败时不应转发.
其他终端上传的消息不应转发.
基础消息服务器端主发的消息所有服务器端主发的消息均要求客户端应答,应答分为通用应答和专门应答,由各具体功能协议决定.
发送方等待应答超时后,应对消息进行重发.
应答超时时间和重传次数由服务器端参数指定,每次重传后的应答超时时间和重传次数由服务器端参数指定,每次重传后的应答超时时间的计算公式见式(1):TN+1=TN*(N+1)1)式中:TN+1——每次重传后的应答超时时间;TN——前一次的应答超时时间;N——重传次数.
客户端主发的消息数据通信链路正常数据通信链路正常时,所有客户端主发的消息均要求服务器端应答,应答分为通用应答和专门应答,由各具体功能协议决定.
客户端等待应答超时后,应对消息进行重发.
应答超时时间和重传次数由客户端参数指定,每次重传后的应答超时时间按式(1)进行计算.
对于客户端发送的关键报警消息,若达到重传次数后仍未收到应答,则应对其进行保存.
以后在发送其它消息前要先发送保存的关键报警消息.
数据通信链路异常数据通信链路异常时,客户端应对需发送的位置信息汇报消息进行保存.
在数据通信链路恢复正常后,立即发送保存的消息.
消息数据格式客户端通用应答消息ID:0x0001.
客户端通用应答消息体数据格式见表B.
6.
客户端通用应答消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的服务器端消息的流水号2应答IDWORD对应的服务器端消息的ID4结果BYTE0:成功/确认;1:失败;2:消息有误;3:不支持服务器端通用应答消息ID:0X8001.
服务器端通用应答消息体数据格式见表B.
7.
服务器端通用应答消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的客户端消息的流水号2应答IDWORD对应的客户端消息的ID4结果BYTE0:成功/确认;1:失败;2:消息有误;3:不支持客户端心跳消息ID:0x0002.
客户端在没有正常业务消息的情况下应按照参数设置的时间间隔定期向服务器端发送心跳消息以维持链路的连接,客户端心跳消息体数据为空.
补传分包请求消息ID:0x8003.
补传分包请求消息体数据格式见表B.
8.
补传分包请求消息体数据格式起始字节字段数据类型描述及要求0原始消息流水号WORD对应要求补传的原始消息第一包的消息流水号4重传包总数BYTEn5重传包ID列表BYTE[2*n]重传包序号顺序排列,如"包ID1包ID2……包IDn"注:对此消息的应答应采用原始消息将重传包ID列表中的分包重发一次,与原始分包消息完全一致.
终端注册消息ID:0X0100.
计时终端安装到车辆上时,使用此消息通知计时平台,终端注册消息体数据格式见表B.
9.
终端注册消息体数据格式起始字节字段数据类型描述及要求0省域IDWORD标示终端安装车辆所在的省域,0保留,由平台取默认值.
省域ID采用GB/T2260中规定的行政区划代码6位中前2位2市县域IDWORD标示终端安装车辆所在的市域和县域,0保留,由平台取默认值.
市县域ID采用GB/T2260中规定的行政区划代码6位中后4位4制造商IDBYTE[5]5个字节,终端制造商编码9终端型号BYTE[20]20个字节,此终端型号由制造商自行定义,位数不足20位的,后补"0X00"29计时终端出厂序列号BYTE[7]7个字节,由大写字母和数字组成,此终端ID由制造商自行定义,位数不足时,后补"0X00"36IMEIBYTE[15]国际移动设备标识,ASCII码51车牌颜色BYTE车牌颜色,按照JT/T415-2006的5.
4.
12;未上牌时,取值为052车辆标识STRING车牌颜色为0时,表示车辆VIN;否则,表示公安交通管理部门颁发的机动车号牌终端注册应答消息ID:0x8100.
终端注册应答消息体数据格式见表B.
10.
终端注册应答消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的终端注册消息的流水号2结果BYTE0:成功;1:车辆已被注册;2:数据库中无该车辆;3:终端已被注册;4:数据库中无该终端.
只有在成功后才返回以下内容3平台编号BYTE[5]统一编号8培训机构编号BYTE[16]统一编号24计时终端编号BYTE[16]统一编号40证书口令BYTE[12]终端证书口令52终端证书STRING由计时平台向全国驾培平台申请终端注销消息ID:0X0003计时终端拆除时使用此消息通知计时平台,终端注销消息体为空.
终端鉴权消息ID:0x0102计时终端使用此消息日常登录到计时平台,鉴权终端鉴权消息体数据格式见表B.
11.
鉴权信息消息体起始字节字段数据类型描述及要求0时间戳DWORD从格林威治时间1970年01月01日00时00分00秒起至现在的总秒数4鉴权密文STRINGBYTE[256]使用终端证书通过加密算法对(计时终端编号、时间戳)进行加密注:多次鉴权中不应使用同一个时间戳进行加密,否则平台返回相应错误码.
平台登录请求消息ID:0X01F0.
计时平台或远程教育平台登录监管服务平台、监管服务平台登录全国驾培平台时使用此消息,平台登录请求消息体数据格式见表B.
12.
平台登录请求消息体数据格式起始字节字段数据类型描述及要求0平台编号BYTE[5]统一编号5密码BYTE[8]登录密码,由大小写字母、数字和下划线组成13平台接入码DWORD上级平台为下级平台分配的唯一标识码平台登录应答消息ID:0X81F0.
平台登录应答消息体数据格式见表B.
13.
平台登录应答消息体数据格式起始字节字段数据类型描述及要求0应答结果BYTE验证结果,定义如下:0:成功;1:IP地址不正确;2:接入码不正确;3:该平台没有注册;4:密码错误;5:资源紧张,稍后再连接(已经占用);9:其他.
平台登出请求消息消息ID:0X01F1.
计时平台或远程教育平台在中断与监管服务平台、监管服务平台在中断与全国驾培平台的链路连接时,应向监管服务平台或全国驾培平台发送平台登出请求消息,平台登出请求消息数据格式见表B.
14.
平台登出请求消息体数据格式起始字节字段数据类型描述及要求0平台编号BYTE[5]统一编号5密码BYTE[8]登录密码,由大小写字母、数字和下划线组成设置终端参数消息ID:0x8103设置终端参数消息体数据格式见表B.
15.
终端参数消息体数据格式起始字节字段数据类型描述及要求0参数总数BYTE1分包参数个数BYTE本数据包包含的参数个数2参数项列表参数项格式见表B.
16终端参数项字段数据类型描述及要求参数IDDWORD参数ID定义及说明表目,具体定义见表B.
17参数长度BYTE参数值DWORD或STRING,若为多值参数,则消息中使用多个相同ID的参数项,如调度中心电话号码终端参数设置各参数项定义及说明参数ID数据类型描述及要求0x0001DWORD客户端心跳发送间隔,单位为秒(s)0x0002DWORDTCP消息应答超时时间,单位为秒(s)0x0003DWORDTCP消息重传次数0x0004DWORDUDP消息应答超时时间,单位为秒(s)0x0005DWORDUDP消息重传次数0x0006DWORDSMS消息应答超时时间,单位为秒(s)0x0007DWORDSMS消息重传次数0x0008-0x000F保留0x0010STRING主服务器APN,无线通信拨号访问点.
若网络制式为CDMA,则该处为PPP拨号号码0x0011STRING主服务器无线通信拨号用户名0x0012STRING主服务器无线通信拨号密码0x0013STRING主服务器地址,IP或域名0x0014STRING备份服务器APN,无线通信拨号访问点0x0015STRING备份服务器无线通信拨号用户名0x0016STRING备份服务器无线通信拨号密码0x0017STRING备份服务器地址,IP或域名0x0018DWORD服务器TCP端口0x0019DWORD服务器UDP端口0x001A-0x001F保留0x0020DWORD位置汇报策略,0:定时汇报;1:定距汇报;2:定时和定距汇报0x0021DWORD位置汇报方案,0:根据ACC状态;1:根据登录状态和ACC状态,先判断登录状态,若登录再根据ACC状态0x0022DWORD驾驶员未登录汇报时间间隔,单位为秒(s),>00x0023-0x0026DWORD保留0x0027DWORD休眠时汇报时间间隔,单位为秒(s),>00x0028DWORD紧急报警时汇报时间间隔,单位为秒(s),>00x0029DWORD缺省时间汇报间隔,单位为秒(s),>00x002A-0x002BDWORD保留0x002CDWORD缺省距离汇报间隔,单位为米(m),>00x002DDWORD驾驶员未登录汇报距离间隔,单位为米(m),>00x002EDWORD休眠时汇报距离间隔,单位为米(m),>00x002FDWORD紧急报警时汇报距离间隔,单位为米(m),>00x0030DWORD拐点补传角度,TCP端口;UDP端口;制造商ID;硬件版本;固件版本;连接到指定服务器时限",若某个参数无值,则放空2命令参数格式见表B.
28控制终端连接指定服务器.
参数之间采用英文分号分隔.
控制指令如下:"连接控制;监管平台鉴权码;拨号点名称;拨号用户名;拨号密码;IP地址;TCP端口;UDP端口;连接到指定服务器时限",若某个参数无值,则放空,若连接控制值为1,则无后继参数3无终端关机4无终端复位5无终端恢复出厂设置6无关闭数据通信7无关闭所有无线通信命令参数格式字段数据类型描述及要求连接控制BYTE0:切换到指定监管平台服务器,连按到该服务器后即进入应急状态,此状态下仅有下发控制指令的监管平台可发送包括短信在内的控制指令;1:切换回原缺省监控平台服务器,并恢复正常状态拨号点名称STRING一般为服务器APN,无线通信拨号访问点,若网络制式为CDMA,则该值为PPP连接拨号号码拨号用户名STRING服务器无线通信拨号用户名拨号密码STRING服务器无线通信拨号密码地址STRING服务器地址,IP或域名TCP端口WORD服务器TCP端口UDP端口WORD服务器UDP端口制造商IDBYTE[5]终端制造商编码监管平台鉴权码STRING监管平台下发的鉴权码,仅用于终端连接到.
监管平台之后的鉴权,终端连接回原监控平台还用原鉴权码硬件版本STRING终端的硬件版本号,由制造商自定固件版本STRING终端的固件版本号,由制造商自定URL地址STRING完整URL地址连接到指定服务器时限WORD单位:min,值非0表示在终端接收到升级或连接指定服务器指令后的有效期截止前,终端应连回原地址.
若值为0,则表示一直连接指定服务器位置信息查询消息ID:0x8201.
位置信息查询消息体为空.
位置信息查询应答消息ID:0x0201.
位置信息查询应答消息体数据格式见表B.
29.
位置信息查询应答消息体数据格式起始字节字段数据类型描述及要求0位置信息汇报位置信息汇报见B.
3.
2.
3.
16临时位置跟踪控制消息ID:0x8202.
临时位置跟踪控制消息体数据格式见表B.
30.
临时位置跟踪控制消息体数据格式起始字节字段数据类型描述及要求0时间间隔WORD单位为s,0则停止跟踪.
停止跟踪无需带后继字段2位置跟踪有效期DWORD单位为s,终端在接收到位置跟踪控制消息后,在有效期截止时间之前,依据消息中的时间间隔发送位置汇报数据下行透传消息ID:0x8900.
数据下行透传消息体数据格式见表B.
31.
数据下行透传消息体数据格式起始字节字段数据类型描述及要求0透传消息类型BYTE1透传消息内容见B.
4.
1数据上行透传消息ID:0x0900.
数据上行透传消息体数据格式见表B.
32.
数据上行透传消息体数据格式起始字节字段数据类型描述及要求0透传消息类型BYTE0x13为驾培业务1透传消息内容见B.
4.
1扩展计时培训消息扩展计时培训消息基础扩展计时培训消息基本约定学员培训过程相关信息的传输消息采用JT/T808标准0x8900透传数据下行和0x0900透传数据上行进行扩展形成.
透传消息类型定义为0x13.
对于客户端上传的实时信息,服务器端收到报告后,如果有专用应答则应回复专用应答消息,如果没有专用应答,则应回复通用应答.
应答消息在无特别说明情况下应使用发起方的作业序号、作业时间以及消息时效类型.
对于服务器端短时间发送的多次请求指令,客户端应答消息可以回复失败予以拒绝,时间参数可自行设置.
对于客户端上传的补传信息,服务器端应回复通用应答.
终端发送消息重传的超时时间与重传次数按照JT/T808中8.
8表11规定的参数ID0x0001-0x0007确定.
平台发送信息重传的超时时间应为30s,重传次数应为3次.
分包消息也应对每一个分包回复通用应答.
扩展计时培训消息内容定义扩展计时培训消息内容数据格式定义见表B.
33:扩展计时培训消息体数据格式起始字节字段数据类型描述及要求0透传消息IDWORD透传消息ID为功能编号+消息编号,例如:0x0102上报教练员登出协议,功能号为0x01,消息号为0x02.
2扩展消息属性WORDbit0表示消息时效类型,应答中也应附带此内容,0:实时消息,1:补传消息;bit1表示应答属性,0:不需要应答,1:需要应答;bit4-7表示加密算法,0:未加密,1:SHA1,2:SHA256;其他保留4驾培包序号WORD扩展驾培协议包序号,从1开始,除协议中特别声明外,循环递增6计时终端编号BYTE[16]统一编号22数据长度DWORDWORD数据内容的长度n,没有数据内容则为024数据内容BYTE[n]根据数据长度要求确定,可无此字段.
24+n校验串STRINGBYTE[]使用计时终端证书对整个扩展驾培消息(不含校验串)进行加密后生成,采用2048位证书时,长度为256byte.
平台发送的扩展消息无此字段.
消息数据格式教练员登录登出类消息上报教练员登录透传信息ID:0x0101应答属性:0x01上报教练员登录消息数据格式见表B.
34.
上报教练员登录消息数据格式起始字节字段数据类型描述及要求0教练员编号BYTE[16]统一编号16教练员身份证号BYTE[18]ASCII码,不足18位前补0x0034准教车型BYTE[2]A1\A2\A3\B1\B2\C1\C2\C3\C4\D\E\F36基本GNSS数据包BYTE[28]见表B.
21教练员登录应答透传消息ID:0x8101教练员登录应答消息数据格式见表B.
35.
教练员登录应答消息数据格式起始字节字段数据类型描述及要求0登录结果BYTE1:登录成功;2:无效的教练员编号;3:准教车型不符;9:其他错误1教练编号BYTE[16]统一编号17是否报读附加消息BYTE0:根据全局设置决定是否报读;1:需要报读;2:不必报读18附加消息长度BYTE长度为n,无附加数据则为019附加消息STRING上报教练员登出透传消息ID:0x0102应答属性:0x01上报教练员登出消息数据格式见表B.
36.
上报教练员登出消息数据格式起始字节字段数据类型描述及要求0教练编号BYTE[16]统一编号16基本GNSS数据包BYTE[28]见表B.
21教练员登出应答透传消息ID:0x8102教练员登出应答消息数据格式见表B.
37.
教练员登出应答消息数据格式起始字节字段数据类型描述及要求0登出结果BYTE1:登出成功;2:登出失败;9:其他错误1教练编号BYTE[16]统一编号学员训练类消息上报学员登录透传消息ID:0x0201应答属性:0x01上报学员登录消息数据格式见表B.
38.
上报学员登录消息数据格式起始字节字段数据类型描述及要求0学员编号BYTE[16]统一编号16当前教练编号BYTE[16]统一编号32培训课程BCD[5]课程编码见A4.
237课堂IDDWORD标识学员的一次培训过程,计时终端自行使用41基本GNSS数据包BYTE[28]见表B.
21学员登录应答透传消息ID:0x8201学员登录应答消息数据格式见表B.
39.
学员登录应答消息数据格式起始字节字段数据类型描述及要求0登录结果代码BYTE1:登录成功;2:无效的学员编号;3:禁止登录的学员;4:区域外教学提醒;5:准教车型与培训车型不符;9:其他错误1学员编号BYTE[16]统一编号17总培训学时WORD单位:min19当前培训部分已完成学时WORD单位:min21总培训里程WORD单位:1/10km23当前培训部分已完成里程WORD单位:1/10km25是否报读附加消息BYTE0:不必报读;1:需要报读26附加消息长度BYTE长度为n,无附加数据则为027附加消息STRING最大254Bytes上报学员登出透传消息ID:0x0202应答属性:0x01上报学员登出消息数据格式见表B.
40.
上报学员登出消息数据格式起始字节字段数据类型描述及要求0学员编号BYTE[16]统一编号16登出时间BCD[6]YYMMDDhhmmss22学员该次登录总时间WORD单位:min24学员该次登录总里程WORD单位:1/10km26课堂IDDWORD标识学员的一次培训过程,计时终端自行使用30基本GNSS数据包BYTE[28]见表B.
21学员登出应答透传消息ID:0x8202学员登出应答消息数据格式见表B.
41.
学员登出应答消息数据格式起始字节字段数据类型描述及要求0登出结果BYTE1:登出成功;2:登出失败;9:其他错误1学员编号BYTE[16]上报学时记录透传消息ID:0x0203应答属性:0x01对于上报学时记录消息,服务器端应回复通用应答,此消息可盲区补传,其数据格式见表B.
42.
上报学时记录消息数据格式起始字节字段数据类型描述及要求0学时记录编号BYTE[26]见A4.
126上报类型BYTE0x01:自动上报;0x02:应中心要求上报.
如果是应中心要求上传,则本次上传作业的驾培包作业序号保持与请求上传消息的驾培包作业序号一致,后续分段上传的驾培包作业序号也保持一致.
27学员编号BYTE[16]统一编号43教练编号BYTE[16]统一编号59课堂IDDWORD标识学员的一次培训过程,计时平台自行使用63记录产生时间BCD[3]格式:HHmmss,1min最后1s的时间66培训课程BCD[5]课程编码,见A4.
271记录状态BYTE0:正常记录;1:异常记录72最大速度WORD1min内车辆达到的最大卫星定位速度,1/10km/h74里程WORD车辆1min内行驶的总里程,1/10km,76附加GNSS数据包BYTE[328]1min内第30s的卫星定位数据,见表B.
21、表B24,由位置基本信息+位置附加信息项中的里程和发动机转速组成命令上报学时记录透传消息ID:0x8205应答属性:0x01服务器下发指令请求客户端上报学时记录,命令上报学时记录消息数据格式见表B.
43.
命令上报学时记录消息数据格式起始字节字段数据类型描述及要求0查询方式BYTE1:按时间上传;2:按条数上传1查询起始时间BCD[6]YYMMDDhhmmss7查询终止时间BCD[6]YYMMDDhhmmss13查询条数WORD命令上报学时记录应答透传消息ID:0x0205客户端回复服务器下发的命令上报学时记录消息时,使用该消息2次回复服务器端,第一次应答0x01开始查询,第二次根据查询结果应答0x02-0x04反馈查询执行结果.
查询结果的反馈通过透传消息ID0x0203实现.
命令上报学时记录应答消息数据格式见表B.
44.
ucloud云服务器怎么样?ucloud为了扩大云服务器市场份额,给出了超低价云服务器的促销活动,活动仍然是此前的Ucloud全球大促活动页面。目前,ucloud国内云服务器2元/月起;香港云服务器4元/首月;台湾云服务器3元/首月。相当于2-4元就可以试用国内、中国香港、中国台湾这三个地域的云服务器1个月了。ucloud全球大促仅限新用户,国内云服务器个人用户低至56元/年起,香港云服务器也仅8...
WHloud Date(鲸云数据),原做大数据和软件开发的团队,现在转变成云计算服务,面对海内外用户提供中国大陆,韩国,日本,香港等多个地方节点服务。24*7小时的在线支持,较为全面的虚拟化构架以及全方面的技术支持!官方网站:https://www.whloud.com/WHloud Date 韩国BGP云主机少量补货随时可以开通,随时可以用,两小时内提交退款,可在工作日期间全额原路返回!支持pa...
热网互联怎么样?热网互联(hotiis)是随客云计算(Suike.Cloud)成立于2009年,增值电信业务经营许可证:B1-20203716)旗下平台。热网互联云主机是CN2高速回国线路,香港/日本/洛杉矶/韩国CN2高速线路云主机,最低33元/月;热网互联国内BGP高防服务器,香港服务器,日本服务器全线活动中,大量七五折来袭!点击进入:热网互联官方网站地址热网互联香港/日本/洛杉矶/韩国cn2...