标准内容
ICS 35.240.60
备案号:
中华人民共和国交通运输行业标准JT/T1206—2018
长江航运信息系统
数据交换共享规范
Yangtze River shipping information system-Specifications for data exchanging and sharing2018-05-22发布
中华人民共和国交通运输部
2018-08-01实施
规范性引用文件
术语和定义
缩略语
5基于套接字通信接口方式的数据交换6基于网络服务接口方式的数据交换7
基于前置机方式的数据交换
JT/T1206—2018
本标准按照CB/T1.1—2009给出的规则起草本标准由交通运输信息通信及导航标准化技术委员会提出并归口。本标准起草单位:长江航运信息中心。JT/T1206-—2018
本标准主要起草人:杜经农、熊劲磊、刘青、邓燕、张娜、付晓坤、李廷文、李慧琴、曾越1范围
长江航运信息系统
数据交换共享规范
JT/T1206—2018
本标准规定了长江航运信息系统采用基于套接字通信接口方式、网络服务接口方式和前置机方式进行数据交换的格式、内容和技术要求。本标准适用于长江航运数据交换平台与长江航运各类信息系统之间的数据交换与共享。其他信息系统的开发建设及系统间的数据交换与共享可参照使用2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件JT/T697.1
JT/T 697.3
JT/T697.4
JT/T697.5
JT/T697.8
JT/T697.12
JT/T1021
交通信息基础数据元第1部分:总则交通信息基础数据元第3部分:港口信息基础数据元交通信息基础数据元第4部分:航道信息基础数据元交通信息基础数据元第5部分:船舶信息基础数据元交通信息基础数据元第8部分:水路运输信息基础数据元交通信息基础数据元第12部分:船载客货信息基础数据元交通运输信息系统基于XML的数据交换通用规则JT/T10582016
交通运输信息系统数据库学段命名及属性定义3术语和定义
下列术语和定义适用于本文件。3.1
长江航运信息系统YangtzeRivershippinginformationsystem服务于长江航运行政主管部门及下属单位、沿江地方管理单位和港航企业的,与长江航运业务相关的一系列信息系统。
长江航运数据交换平台YangtzeRivershippingdataexchangeplatform由长江航运行业管理单位建立,提供航运企业各信息系统接入的接口,以统一的接口规范实现数据自动提取、数据转换、数据发送和数据校验等,为不同数据库、不同数据格式之间进行数据交换而提供服务的平台。
套接字通信socketcommunication基于TCP/IP协议,通过建立在传输层协议上的套接字规范进行的稳定连接的点对点通信。3.4
网络服务
webservice
使用开放协议进行通信的低耦合自包含且可自我描述的应用程序组件。1
JT/T1206—2018
前置机frontendprocessor
通过各种通信介质和终端进行通信的前置设备。3.6
基于前置机方式的数据交换
dataexchangebased on thefront endprocessormode通过前置机的前置交换数据库、应用适配器和数据交换软件实现数据交换的方式。4缩略语
下列缩略语适用于本文件。
AIS-船舶自动识别系统(AutomaticIdentificationSystem)ASCII美国信息交换标准代码(AmericanStandardCodeforInformationInterchange)CDMA——码分多址(CodeDivisionMultipleAccess)-中央处理器(CentralProcessingUnit)CPU-
CRC—循环穴余校验(CyclicRedundancyCheck)FTP——文件传输协议(FileTransferProtocol)GBK——汉字内码扩展规范(ChineseIntermnalCodeSpecification)GPRS-
通用分组无线服务(GeneralPacketRadioService)全球定位系统(GlobalPositioningSystem)GPS
GSM全球移动通信系统(GlobalSystemforMobileCommunications)IP——网际协议(InternetProtocol)MD5——消息摘要算法第五版(MessageDigestAlgorithm5)MMSI—水上移动通信业务标识码(MaritimeMobileServiceIdentify)SIM——客户识别模块(SubscriberIdentificationModule)TCP/IP————传输控制协议/因特网互联协议(TransmissionControlProtocol/InternetProtocol)VTS——船舶交通管理系统(VesselTrafficServices)5基于套接字通信接口方式的数据交换5.1
接口方式
长江航运信息系统中船舶位置数据交换宜采用基于套接字通信接口方式5.2连接流程
5.2.1建立连接
船舶位置数据交换建立连接过程的步骤如下:a)通过指定的主机和端口号,客户端创建套接字通信实例,连接到长江航运数据交换平台;b)客户端向服务器端发送长江航运数据交换平台分配的用户名和密码等身份认证消息报文,消息报文格式见5.3.2.1。bzxz.net
5.2.2身份认证
船舶位置数据交换身份认证过程的步骤如下:a)服务器接收到客户端的身份认证消息并完成身份信息验证后,反馈请求连接认证结果消息报2
文,消息报文格式见5.3.2.2;
若通过认证,向客户端发送船舶位置数据;若未通过认证,断开连接。b)
5.2.3数据接收
JT/T1206—2018
客户端接收到服务器发送的二进制格式船舶位置数据报文后,按照5.4中的报文规范对二进制数据转换后,进行数据接收和处理。5.2.4关闭连接
数据交换完成后,未收到维持连接的心跳数据包或客户端自主请求关闭连接,服务器端应关闭连接,监听另一请求。
5.3报文格式
5.3.1报文结构
船舶位置数据交换报文通信协议结构包括协议头、协议体和协议尾。通信协议结构见表1。表1
通信协议结构
协议顺序协议结构
协议头
协议体
协议尾
参数名称
报文起始标志
报文长度
命令字
版本号
数据体
校验位
*参数的长度为“不定长LEN”
参数类型长度
string
标记报文的开始位置,本协议约定以“OxEAEA\为固定报文起始标志
包括协议头和协议尾在内的协议总长用来标识协议功能的代码,本协议中命令字主要为0OxD1、0x81、0xDO三种
协议顿传输时的流水号,循环自增高位表示主版本号,低位表示次版本号协议数据
采用CRC-16校验,被校验内容为除校验位外的所有部分协议中,协议头、协议体与协议尾之间以冒号(:)为分隔符通信数据体中的字段以逗号(,)为分隔符,字符编码英文采用ASCII,中文编码采用GBK,分隔符采用半角编码。协议中命令字主要有0xD1、0x81和0xD0三种,也可根据需要添加。命令字定义见表2。表2命令字定义
CONNECT
CONNECT_RESP
GPSData
命令字
请求连接
请求连接反馈
定位数据共享
JT/T1206—2018
5.3.2报文体
5.3.2.1请求连接
通过命令字0xD1定义请求连接报文。请求连接协议体格式见表3。请求连接协议体格式
参数名
节点登录用户名
节点登录密码
时间截
字段名
TIMESTAMP
请求连接反馈
string
string
长江航运数据交换平台提供的用户名129
MD5哈希算法加密的登录密码
客户端产生的时间戳,格式为:MMDDh-hmmss,即月日时分秒
通过命令字0x81定义请求连接反馈报文。请求连接反馈协议体格式见表4。表4
参数名
认证结果
用户单位
字段名
STATUS
COMPANY
报文数据校验算法
请求连接反馈协议体格式
string
报文采用CRC16循环校验算法进行数据校验:unsignedINTCRCtbI[256]=
参数值:0:登录成功;1:消息结构错;2:非登录用户名:3:认证错;4:版本太高;5:该用户已登录:6:该用户已锁定:其他值:其他错误
认证成功将返回用户单位名称
0x0000,0xC0C1,0xC181,0x0140,0xC301,0x03C0,0x0280,0xC241,0xC601,0x06C0,0x0780,0xC741,0x0500,0xC5C1,0xC481,0x0440,0xCC01,0x0CCO,0x0D80,0xCD41,0x0F00,0xCFC1,0xCE81,0x0E40,0x0A00,0xCAC1,0xCB81,0x0B40,0xC901,0x09C0,0x0880,0xC841,0xD801,0x18C0,0x1980,0xD941,0x1B00,0xDBC1,0xDA81,0x1A40,0x1E00,0xDEC1,0xDF81,0x1F40,0xDD01,0x1DC0,0x1C80,0xDC41,0x1400,0xD4C1,0xD581,0x1540,0xD7010x17C0,0x1680,0xD641,0xD201,0x12C0,0x1380,0xD341,0x1100,0xD1C1,0xD081,0x1040,0xF0010x30C0.0x3180,0xF141,0x3300.0xF3C1.0xF281.0x32400x3600,0xF6C1,0xF781,0x3740,0xF501,0x35C0,0x3480,0xF441,0x3C000xFCC1,0xFD81,0x3D40,0xFF01,0x3FC0,0x3E80,0xFE41,0xFA01,0x3AC0,0x3B80,0xFB41,0x3900,0xF9C1,0xF881,0x3840,0x2800,0xE8C1,0xE981,0x2940,0xEB01,0x2BC0,0x2A80,0xEA41,0xEE01,0x2EC0.0x2F800xEF41.0x2D00.0xEDC1,0xEC81.0x2C400xE401,0x24C0,0x2580,0xE541,0x2700,0xE7C1,0xE681,0x26404
Ox2200,0xE2C1,0xE381,0x2340,0xE101,0x21C0,0x2080,0xE041,0xA0010x60C0,0x6180,0xA141,0x6300,0xA3C1,0xA281,0x6240,0x6600,0xA6C1,0xA781,0x6740,0xA501,0x65C0,0x6480,0xA441,0x6C00,0xACC1,0xAD81,0x6D40,0xAF01,0x6FC0,0x6E80,0xAE41,0xAA01,0x6AC0,0x6B80,0xAB41,0x6900,0xA9C1,0xA881,0x6840,0x7800,0xB8C1,0xB981,0x7940,0xBB01,0x7BC0,0x7A80,0xBA41,0xBE01,0x7EC0,0x7F80,0xBF410x7D00,0xBDC1,0xBC81,0x7C40,0xB401,0x74C0,0x7580,0xB541,0x7700,0xB7C1,0xB681,0x7640,0x7200,0xB2C1,0xB381,0x7340,0xB101,0x71C0,0x7080,0xB041,0x5000,0x90C1,0x9181,0x5140,0x9301,0x53C0,0x5280,0x9241,0x9601,0x56C0,0x5780,0x9741,0x5500,0x95Cl,0x9481,0x5440,0x9C01,0x5CC0,0x5D80,0x9D41,0x5F00,0x9FC1,0x9E81,0x5E400x5A00,0x9AC1,0x9B81,0x5B40,0x9901,0x59C0,0x5880,0x9841,0x8801,0x48C0,0x4980,0x89410x4B00,0x8BC1,0x8A81,0x4A40,0x4E00,0x8EC1,0x8F810x4F40,0x8D01,0x4DC0,0x4C80,0x8C41.0x4400,0x84C1,0x8581,0x4540,0x8701,0x47C0,0x4680,0x86410x8201,0x42C0,0x4380,0x8341,0x4100,0x81C1,0x8081,0x40401;unsigned SHORT addCRC( unsigned SHORT CRC, unsigned char b )return(CRC ≥>8)CRCtbl[(CRC&OxFF)b];WORD getcrc(const UCHAR * sbuf, INTlen)constunsigned char*p;
unsigned SHORT crcdata =Oxfff;p=sbuf;
for(INTi=O;icrcdata=addCRC(crcdata,p[i]);returncrcdata;
5.4交换内容
通过命令字0xDO定义定位数据共享报文。定位数据交换内容见表5定位数据交换内容
参数名
船舶MMSI号
定位时间
字段名
GPSTIME
string
string
船舶MMSI编号
定位数据当前时间
JT/T1206—2018
JT/T1206—2018
参数名
状态码
通道标识
字段名
LONGITUDE
LATITUDE
STATUS
表5(续)
船舶所处位置的经度信息,6位小数船舶所处位置的纬度信息,6位小数航行速度,2位小数,单位:千米每小时(km/h)
船崩向,精确到0.10
终端状态.0:正常:1:终端故障参数值:0:GSM;1:GPRS/CDMA;2:AIS:3:VTS
船舶位置数据仅包含动态位置信息,应通过设备关联信息表(见7.7.3.7)与船舶基础信息表(见7.7.3.2)关联后使用。
关联方法如下:
将定位数据的船舶MMSI号(MMSI)与设备关联信息表中船舶MMSI号(TARGEMMSI)关联,a)
可确定船舶的英文船名(TARGETNAME)和中文船名(CHINESENAME);通过设备关联信息表的英文船名(TARGETNAME)与船舶基础信息表的英文船名(YWCM)关b)
联,或者通过设备关联信息表的中文船名(CHINESENAME)与船舶基础信息表的中文船名(ZWCM)关联,可确定该条位置数据对应的船舶基础信息。6基于网络服务接口方式的数据交换6.1总体要求
第三方需要与长江航运数据交换平台交换气象、水位、港口水情、通航信息、安全信息及航运工具等信息时,应采用网络服务(webservice)接口进行数据交换。按照JT/T1021中有关数据包的定义,基于网络服务接口进行交换的数据包属于简单数据交换包,即数据交换包只包含所需交换的数据内容。数据包由数据包体和数据项组成,数据包体是数据包中涉及业务系统之间需要交换的数据部分,数据项标识每二条需要交换的数据
获取网络服务的步骤
基于网络服务接口的数据交换应以Web方式完成,获取网络服务的步骤如下:第三方需调用webservice接口,应向web service接口服务提供方提出申请;a)
b)webservice接口服务提供方根据第三方的申请,分配授权信息,提供webservice接口访问地址、授权用户、授权码、web service服务的详细接口说明给第三方;c
第三方根据自身需求编写采集工具,并将webservice接口访问地址、授权用户、授权码传递给采集工具,通过webservice接口服务方的验证后,根据权限,返回webservice接口查询结果,未经授权的信息将被拒绝;
第三方将采集到的webservice接口数据进行存储,数据封装使用:e)web service接口服务提供端等待另一访间请求。6
6.3交换内容
6.3.1概述
JT/T1206—2018
webservice接口对外提供信息发布或供第三方调用,应遵循交换内容及报文结构,字段可根据实际应用需求进行扩展。长江航运业务已使用的webservice接口交换数据包含:港口水情,气象、水位、通航信息、安全信息、危险品申报员、验船师查询、验船机构查询和船员培训机构等。6.3.2港口水情接口
港口水情接口包含某一地区某一段时间内港口水情关联详情接口和某一日期所有地区港口水情关联详情接口。某一地区某一段时间内港口水情关联详情接口应提供某一地区某一段时间的港口水情走势,用于港口水情历史数据分析。某一日期所有地区港口水情关联详情接口用于查询某一日期所有长江流域港口水情数据。港口水情数据每天应更新两次,更新时间设置为北京时间11时及17时第三方调用webservice接口应遵守输入参数约定格式,方可获取该接口数据。某一地区某一段时间内港口水情关联详情接口报文结构见表6。表6某一地区某一段时间内港口水情关联详情接口报文结构序号
字段中文名称
气象接口
字段名
sitename
datavalue
timepoint
flowrate
数据类型
string
YYYY-MM-DD
hh:mm:ss
描述长江沿线港口站点名称,如:寸滩日期,如:2016-01-01
描述监测港口水情的时间点,时间采用24小时制,精确到秒,如:17:00:00描述港口水位详细信息,单位为米(m)流量,单位为立方米每秒(m2/s)气象接口包含地区气象走势接口和某一日期所有地区气象接口。地区气象走势接口应提供某一地区某一段时间的地区气象走势,用于合理安排船舶出行计划。某一日期所有地区气象接口用于查询某日期所有长江流域地区气象数据。气象数据每天应更新两次,更新时间设置为北京时间11时及17时。长江航运数据交换平台对地区气象走势接口报文结构见表7。表7地区气象走势接口报文结构
字段中文名称
城市名
高温度
低温度
风向、风力及雾
字段名
weather
hightemperature
lowtemperature
environment
qxdate
timepoint
数据类型
string
string
string
YYYY-MM-DD
hh:mm:8s
描述长江沿线地区的名称,如:重庆,丰都描述地区天气情况,如:阴天转多云预报的最高温度,单位为摄氏度(℃)预报的最低温度,单位为摄氏度(℃)描述风向、风力及雾的情况,如:北风三级以下,有大于1500m雾等
日期,如:2016-01-01
描述监测港口水情的时间点,时间采用24小时制,精确到秒,如:17:00:007
JT/T1206—2018
6.3.4水位接口
水位接口包含某一地区某一段时间内水位公告关联详情和某一日期所有地区水位公告关联详情某二地区某一段时间内水位公告关联详情应提供某一二地区某一段时间内水位详情,用于分析地区水位走势。某一日期所有地区水位公告关联详情用于查询某一日期所有长江流域地区的水位数据。水位数据每天应更新两次,更新时间设置为北京时间11时及17时。长江航运数据交换平台某一日期所有地区水位公告关联详情接口报文结构见表8。表8某一日期所有地区水位公告关联详情接口报文结构序号
字段中文名称
城市名
栏目信息接口
字段名
datevalue
数据类型
string
varchar
string
YYYY -MM -DD
描述长江沿线地区的名称,如:重庆、丰都描述地区水位详细信息,单位为米(m)描述水位涨落的状态
日期,如:2016-01-01
栏目信息接口包含所有信息栏目和信息内容,按栏目读取。长江航运数据交换平台中,栏目信息接口应提供航行通告、航道信息、安全预警、安全形势、事故险情等栏目详情,新闻数据每天应更新一次栏目信息接口报文结构见表9。
字段中文名称
栏目编号
栏目名称
栏目的父级编号
点击次数
字段名
classid
parentid
newstitle
newsdetail
clicks
6.3.6船员培训机构详情接口
栏目信息接口报文结构
数据类型
string
string
string
string
用自然数表示,用于数据库中标识栏目类别,便于查找、排序
按其内容分为若干栏,如:航道信息编号为\0\时代表顶级栏目
描述某一新闻标题
描述新闻的详细信息
新闻标签
描述该新闻的点击浏览次数,是反映新闻热度的指标之
船员培训机构详情接口包含船员培训机构及培训项目详情。船员培训机构数据每月应更新一次船员培训机构详情接口报文结构见表108
字段中文名称
机构代码
培训地点
联系人
联系电话
培训项目
项目代码
培训规模
考试发证机关
字段名
organcode
training
project
危险品申报员接口
船员培训机构详情接口报文结构数据类型
string
string
string
string
string
string
string
string
JT/T1206—2018
标识船员培训机构的代码,通常采用数字an..9
标识,如:6501,也可根据实际情况,采用字符形式标识
描述培训地点的详细地址
培训机构联系人员
-般为座机电话
培训项目简介
培训项目代码,描述数据库中项目编号,便于查询
培训机构规模、师资力量等描述信息描述船员参加培训且考试合格,取得证书的考试发证机关
危险品申报员接口包含危险品申报员基本信息与资格信息。危险品申报员数据每月应更新一次。危险品申报员接口报文格式见表11。表11
字段中文名称
货申编号
装箱员编号
所属海事
取得证书时间
船申编号
字段名
zxynum
qdtime
shipnum
验船机构详情接口
危险品申报员接口报文结构
数据类型
string
string
string
string
string
string
string
YYYY-MM-DD
危险品申报员姓名
描述危险品申报员的性别
危险品申报员所属单位
危险品货物的申请编号
危险品集装箱编号
证书颁发机构所属海事局
取得证书时间,日期,如:2016-01-01用于标识危险品申报员所申请的船申编号验船机构详情接口包含验船机构详细信息,可用于查询验船机构基本信息及业务范围。验船机构数据每月应更新一次。验船机构详情接口报文格式见表12。9
小提示:此标准内容仅展示完整标准里的部分截取内容,若需要完整标准请到上方自行免费下载完整标准文档。