【JT交通运输标准】 内河船舶能耗在线监测第2部分:数据交换

ICS03.220.40:35.240.60
备案号：
中华人民共和国交通运输行业标准JT/T1225.2—2018
内河船舶能耗在线监测
第2部分：数据交换
Online energy consumption monitoring for inland vessel-Part2：Dataexchange
2018-08-29发布
中华人民共和国交通运输部
2018-12-01实施
规范性引用文件
术语和定义、缩略语·
数据交换内容
数据交换格式
数据交换频率，
数据交换方法
附录A（规范性附录）
Web服务接口API方法
JT/T1225.2—2018
JT/T1225《内河船舶能耗在线监测》分为2个部分：第1部分：平台技术要求；
一第2部分：数据交换
本部分为JT/T1225的第2部分。
本部分按照GB/T1.1-2009给出的规则起草。本部分由交通运输信息通信及导航标准化技术委员会提出并归口。本部分起草单位：交通运输部科学研究院JT/T1225.2—2018
本部分主要起草人：王里、刘燕灵、崔应寿、刘浩、曹剑东、于丹阳、陈建华、黄海涛、胡希元、周健隋丽娜、刘振华、路敖青、武丽、王灿、秦芬芬、林成功、梁鸿旭、傅昭南、姚晶莹、桑美英、陈嘉玉、夏晶、付一方。
1范围
JT/T1225.2-2018
内河船舶能耗在线监测第2部分：数据交换JT/T1225的本部分规定了内河船舶能耗在线监测平台之间进行数据交换的内容、格式、频率和方法。
本部分适用于内河船舶能耗在线监测平台之间的数据交换与共享。2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB32100-2015
JT/T697.12013
JT/T697.5—2013
3术语和定义、缩略语
3.1术语和定义
法人和其他组织统一社会信用代码编码规则交通信息基础数据元第1部分：总则交通信息基础数据元
第5部分：船舶信息基础数据元
JT/T697.1-—2013界定的以及下列术语和定义适用于本文件。3.1.1
数据表
datatable
结构型关系数据库中的二维表，其中列称为字段、行称为记录。3.1.2
上级机构
supervisingauthority
船舶经营业户所属的行政管理机构或行政管理机构的上一级行政管理机构3.2缩略语
下列缩略语适用于本文件。
API—应用程序编程接口（ApplicationProgrammingInterface）ID标识符（IDentifier）
JavaScript对象表示法（JavaScriptObjectNotation）UTF-8-
8位统一码转换格式（8-bitUnicodeTransformationFormat）可扩展标记语言（ExtensibleMarkupLanguage）4数据交换内容
内河船舶能耗在线监测数据分为静态、动态和周期汇总三大类信息。每类信息的交换内容包括若干不同数据表，数据交换内容见表1。每张数据表由多个字段构成，字段的数据类型和数据格式遵循JT/T697.1—2013的规定
JT/T1225.2—2018
信息分类
周期汇总
数据交换格式
机构信息
数据表名称
机构信息
船舶信息
单船能源消耗量
单船航次
单船能源消耗量汇总
机构信息数据交换格式见表2。
字段名称
机构统一社会
信用代码
机构名称
上级机构统
社会信用代码
船舶信息
字段标识
数据交换内容
数据表标识
nhje_nhcb_jgxx
nhje_nhcb_cbxx
nhjc_nheb_denyxhl
nhjc_nheb_dche
nhjc_nhcb_denyxhlhz
内河船舶能耗在线监测平台（以下简称平台）所拥有的行业管理部门、船舶经营业户等的基本信息
每条船舶的基本信息
定时采集的每条船舶的能源消耗量信息每条船舶的航次信息
以日、月、季度、年份进行能源消耗量的定期汇总数据
机构信息数据交换格式
数据类型
JGTYSHXYDM
SJJGTYSHXYDM
船舶信息数据交换格式见表3。
字段名称
船舶识别号
船舶登记号
中文船名
船籍港代码
船籍港名称
初次登记号
船舶种类代码
字段标识
CBZLDM
字符型
字符型
字符型
数据格式
船舶信息数据交换格式
数据类型
字符型
字符型
字符型www.bzxz.net
字符型
字符型
字符型
字符型
数据格式
说明及要求
见CB32100—2015
企业、事业单位、机关、社会团体及其他依法成立的单位的名称
上级机构的统一社会信用代码；如无上级机构则为空
说明及要求
见JT/T697.5—2013中4.1.1.41
见JT/T697.52013中4.1.1.1
见JT/T697.5—2013中4.1.1.2
见JT/T697.5-2013中4.1.1.9
见JT/T697.52013中4.1.L.10
见JT/T697.5—2013中4.1.1.12
见JT/T697.5-2013中4.1.1.13
字段名称
主机功率
船舶营业运输证编号
船舶营业运输证
签发机构ID
船舶日常管理机构ID
经营业户名称
经营业户机构ID
经营业户类型
额定载货量
单船能源消耗量
字段标识
CBYYYSZBH
CBYYYSZQFJGID
CBRCGLJGID
JYYHMC
JYYHJGID
JYYHLX
单船能源消耗量数据交换格式见表4。表4
字段名称
船舶识别号
航行里程
能源消耗量
实际载货量
单船航次
表3（续）
数据类型
数字型
数字型
数字型
数字型
字符型
字符型
字符型
字符型
字符型
字符型
数字型
数据格式
单船能源消耗量数据交换格式
字段标识
单船航次数据交换格式见表5。
数据类型
字符型
数字型
数字型
数字型
数据格式
JT/T1225.2—2018
说明及要求
见JT/T697.5—2013中4.1.1.35
见JT/T697.5—2013中4.1.1.38
见JT/T697.5-2013中4.1.1.39
见JT/T697.5—2013中4.1.1.40
根据船舶营业运输证填写
采用统一社会信用代码
采用统一社会信用代码
指拥有该船舶经营权的企业或个体经营户的名称，根据船舶营业运输证中的船舶经营人填写
采用统一社会信用代码
指船舶经营业户的经济类型值
域：1-企业；2-个体
根据船舶营业运输证中的载货定额填写，单位：吨（t)
说明及要求
见JT/T697.52013中4.1.1.41
单位：km
内河船舶能耗在线监测数据采集设备（以下简称数据采集设备）上传的累计能源消耗量，单位：升（L）数据采集设备上传的当前实际载货量，单位：吨(t)
JT/T1225.2—2018
字段名称
船舶识别号
航次序号
航次开始时间
航次结束时间
航次起点港口名称
航次终点港口名称
总航行里程
重载航行里程
货运量
货物周转量
集装箱运量
集装箱周转量
单船能源消耗量汇总
字段标识
HCKSSJ
HCJSSJ
HCODGKMC
HCZDGKMC
ZZHXLC
JZXZZL
单船航次数据交换格式
数据类型
字符型
字符型
日期时间型
日期时间型
字符型
字符型
数字型
数字型
数字型
数字型
数字型
数学型
单船能源消耗量汇总数据交换格式见表6。数据格式
YYYYMMDD
hhmmss
YYYYMMDD
hhmmss
说明及要求
见JT/T697.5—2013中4.1.1.41
唯一标识单船航次的序号，按照航次发生时间的顺序以步长1递增上个航次货物卸空的日期
本航次货物卸空的日期
上个航次货物卸空的港口名称
本航次货物卸空的港口名称
本航次的标准航线里程
如在航次中途经多个港口，则需要根据船舶航行路线的顺序，将途经的各港口间标准航线里程进行加总，单位：公里（km）
一个完整航次中发生货物运输的标准航线里程，即从开始装货地点到航次终点的航行里程，单位：公里(km)
运载货物重量，单位：吨（）
一个航次内实际运送的每批货物与其相应航行里程的乘积之和，单位：吨公里（t·km）
指船舶运输集装箱折合20f（1fl=0.3048m）标准箱的数值，若船舶种类为集装箱船时，该字段应不为空。单位：标准箱（TEU）
指船舶运输集装箱折合20f标准
箱时的周转量，船舶种类为集装箱船时，该字段应不为空，单位：标准箱公里（TEU·km）
字段名称
船舶识别号
汇总时间分类代码
开始时间
结束时间
完成航次数
总行程
载运行程
货运量
货物周转量
千吨公里能源消耗
数据交换频率
静态数据
单船能源消耗量汇总数据交换格式字段标识
HZSJFLDM
QDGLNYXH
数据类型
字符型
字符型
日期时间型
日期时间型
数字型
数字型
数字型
数字型
数字型
数字型
静态数据应在数据发生变化后进行交换。动态数据
动态数据应每天交换一次。
周期汇总数据
周期汇总数据应按照汇总周期进行交换。数据交换方法
数据格式
JT/T1225.2—2018
说明及要求
见JT/T697.52013中4.1.1.41
值域：1-按年度汇总；2-按季度汇总：3-按月汇总：4-按日汇总
YYYYMMDD
YYYYMMDD
hhmmss
平台之间数据交换采用Web服务接口API方法，详见附录A。汇总的开始时间
汇总的结束时间
汇总期内完成的航次数
单位：公里（km）
单位：公里（km）
单位：吨(0)
单位：吨公里（t.km）
单位：升每千吨公里[V(kt·km)]5
JT/T1225.2—2018
总体要求
附录A
（规范性附录）
Web服务接口API方法
数据交换的通信数据应采用UTF-8编码。服务API接口的调用应有安全认证机制，以防范未授权的恶意访问。认证方式宜采用令牌方式。静态数据交换API
A.2.1静态数据变化通知API
A.2.1.1功能
数据提供方通知静态数据发生变化，数据请求方收到该通知后给出应答A.2.1.2
2方法
静态数据变化通知API的参数列表和应答数据格式分别见表A.1和表A.2。表A.1
output
data_table_id
status
静态数据变化通知API的参数列表默认值
说明及要求
返回的数据格式，值域为：json-JSON格式；xml-XML格式通知的流水号，用于多个通知与返回的对应，1~10000的连续数字发生变化的数据表标识
静态数据变化通知API的应答数据格式说明及要求
返回的状态码，值域：0-正常；1-错误返回相应的通知流水号
静态数据变化通知API的URL示例如下：“http://api.sjh.xxx.com/jtsjbh/vl/?output=json&lsh=1&data_table_id=nhjc_nhcb_jgxx在以上URL示例中：http://api.sjih。xxx.com/jtsjbh/v1/为服务地址，服务地址由域名（api.sjih.xxx.com）、服务名（jtsjbh）、服务版本号（vl)组成：“？\后面为参数，“&”为参数分隔符。静态数据变化通知API的应答JSON格式数据包示例如图A.1所示。status:0
静态数据变化通知API的应答JSON格式数据包示例6
聚静态数据请求API
A.2.2.1功能
JT/T1225.2—2018
数据请求方向数据提供方发送静态数据请求，数据提供方收到该请求后返回相应的静态数据。A.2.2.2方法
静态数据请求API的参数列表和应答数据格式分别见表A.3和表A.4。表A.3
output
data_table_id
status
result
3示例
默认值
静态数据请求API的参数列表
说明及要求
返回的数据格式，值域为：json-JSON格式：xml-XML格式请求的流水号，用于多个请求与返回的对应，从1～10000的连续数字
请求的数据表ID
请求的数据范围，值域：all-返回整个数据表；change-只返回发生变化的部分
静态数据请求API的应答数据格式表A.4
说明及要求
返回调用状态码，值域：0-正常；1-错误返回相应的请求流水号
分包数，即一次请求的数据可以分多个包发送分包序号，从1开始
本次返回的记录条数
本次返回的数据.包含多条记录
静态数据请求API的URL示例如下：\http://api.sjh.xxx.com/jtsj/vl/?output=json&lsh=1&data_table_id=nhjc_nhcb_jgxx&range=change\。
在以上URL示例中：http：//api.sjh.xxx.com/jtsj/v1/为服务地址，服务地址由域名（api.sjih.xxx.com）、服务名（itsj）、服务版本号（vl）组成；“?\后面为请求参数，“&\为参数分隔符。静态数据请求API的应答JSON格式数据包示例如图A.2所示。该示例返回两条发生变化的记录。
3动态数据交换API
A.3.1功能
数据请求方向数据提供方发送动态数据请求，数据提供方收到该请求后返回相应的动态数据。2方法
动态数据交换API的参数列表和应答数据格式分别见表A.5和表A.6。7
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。