JT-T-1225.2-2018内河船舶能耗在线监测第2部分：数据交换

ICS03.220.40:35.240.60中华人民共和国交通运输行业标准JT/T1225.2—2018Part2:Dataexchange2018-08-29发布2018-12-01实施IJT/T1225.2—2018 1 26数据交换频率 5 5附录A(规范性附录)Web服务接口API方法 6ⅢJT/T1225.2—2018 本部分为JT/T1225的第2部分。本部分按照GB/T1.1—2009给出的规则起草。1JT/T1225.2—2018JT/T697.1—2013交通信息基础数据元第1部分：总则JT/T697.1—2013界定的以及下列术语和定义适用于本文件。3.1.13.1.2干不同数据表，数据交换内容见表1。每张数据表由多个字段构成，字段的数据类型和数据格式遵循JT/T697.1—2013的规定。2JT/T1225.2—2018序号信息分类数据表名称数据表标识1静态机构信息nhjcnhcbjgxx台)所拥有的行业管理部门、船舶经营业户等的2船舶信息nhjcnhcbcbxx每条船舶的基本信息3动态单船能源消耗量nhjcnhcbdenyxhl定时采集的每条船舶的能源消耗量信息4单船航次nhjcnhcbdche每条船舶的航次信息5单船能源消耗量汇总汇总数据机构信息数据交换格式见表2。序号字段名称字段标识数据类型数据格式说明及要求1机构统一社会信用代码JGTYSHXYDM字符型n18见GB32100—20152机构名称JGMC字符型an..100企业、事业单位、机关、社会团体及其他依法成立的单位的名称3上级机构统一社会信用代码SUGTYSHXYDM字符型n18上级机构的统一社会信用代码；如无上级机构则为空序号字段名称字段标识数据类型数据格式说明及要求1船舶识别号CBSBH字符型anl3见JT/T697.5—2013中12船舶登记号CBDJH字符型anl6见JT/T697.5—2013中3中文船名ZWCM字符型an..100见JT/T697.5—2013中4船籍港代码CJGDM字符型见JT/T697.5—2013中5船籍港名称CJGMC字符型an..50见JT/T697.5—2013中06初次登记号CCDJH字符型anl6见JT/T697.5—2013中27船舶种类代码CBZLDM字符型n..4见JT/T697.5-2013中33JT/T1225.2—2018表3(续)序号字段名称字段标识数据类型数据格式说明及要求8主机功率ZJGL数字型n8.2见JT/T697.5—2013中59箱位数字型n..5见JT/T697.5—2013中8客位KW数字型n..5见JT/T697.5—2013中9车位数字型n..5见JT/T697.5—2013中0船舶营业运输证编号CBYYYSZBH字符型an30根据船舶营业运输证填写船舶营业运输证签发机构IDCBYYYSZOFJGID字符型n18采用统一社会信用代码船舶日常管理机构IDCBRCGLJGID字符型n18采用统一社会信用代码经营业户名称JYYHMC字符型an..100指拥有该船舶经营权的企业或个体经营户的名称，根据船舶营业运输证中的船舶经营人填写经营业户机构IDJYYHJGID字符型n18采用统一社会信用代码经营业户类型JYYHLX字符型指船舶经营业户的经济类型值域：1-企业；2-个体额定载货量EDZHL数字型n..3根据船舶营业运输证中的载货定额填写，单位：吨(t)序号字段名称字段标识数据类型数据格式说明及要求1船舶识别号CBSBH字符型见JT/T697.5—2013中12航行里程HXLC数字型n..10,2单位：km3能源消耗量NYXHL数字型n..10,2内河船舶能耗在线监测数据采集设备(以下简称数据采集设备)上传的累计能源消耗量，单位：升(L)4实际载货量数字型n..10,2数据采集设备上传的当前实际载货量，单位：吨(t)单船航次数据交换格式见表5。4JT/T1225.2—2018序号字段名称字段标识数据类型数据格式说明及要求1船舶识别号CBSBH字符型an13见JT/T697.5—2013中12航次序号HCXH字符型n..10唯一标识单船航次的序号，按照航次发生时间的顺序以步长1递增3航次开始时间HCKSSJ日期时间型YYYYMMDDhhmmss上个航次货物卸空的日期4航次结束时间HCJSSJ日期时间型YYYYMMDDhhmmss本航次货物卸空的日期5航次起点港口名称HCQDGKMC字符型an..100上个航次货物卸空的港口名称6航次终点港口名称HCZDGKMC字符型an..100本航次货物卸空的港口名称7总航行里程ZHXLC数字型an..8,2本航次的标准航线里程如在航次中途经多个港口，则需要根据船舶航行路线的顺序，将途经的各港口间标准航线里程进行加总，单位：公里(km)8重载航行里程ZZHXLC数字型an..8.2一个完整航次中发生货物运输的标准航线里程，即从开始装货地点到航次终点的航行里程，单位：公里9货运量HUOYL数字型an..20.4运载货物重量，单位：吨(t)货物周转量HWZZL数字型an..8,2一个航次内实际运送的每批货物与其相应航行里程的乘积之和，单位：吨公里(t·km)集装箱运量JZXXL数字型an..8.2指船舶运输集装箱折合20ft(1ft=0.3048m)标准箱的数值，若船舶种类为集装箱船时，该字段应不为空。单位：标准箱(TEU)集装箱周转量JZXZZL数字型an..8,2指船舶运输集装箱折合20ft标准箱时的周转量，船舶种类为集装箱船时，该字段应不为空，单位：标准箱公里(TEU·km)5JT/T1225.2—2018序号字段名称字段标识数据类型数据格式说明及要求1船舶识别号CBSBH字符型anl3见JT/T697.5—2013中12汇总时间分类代码HZSJFLDM字符型值域：1-按年度汇总；2-按季度汇总；3-按月汇总；4-按日汇总3开始时间KSSJ日期时间型YYYYMMDDhhmmss汇总的开始时间4结束时间JSSJ日期时间型YYYYMMDDhhmmss汇总的结束时间5完成航次数WCHCS数字型n..5汇总期内完成的航次数6总行程ZXC数字型n..18,3单位：公里(km)7载运行程ZYXC数字型n..18,3单位：公里(km)8货运量HUOYL数字型n..18,3单位：吨(t)9货物周转量HWZZL数字型n..18,3单位：吨公里(t·km)千吨公里能源消耗QDGLNYXH数字型n..18,3单位：升每千吨公里[L/(kt·km)]6.1静态数据6.3周期汇总数据周期汇总数据应按照汇总周期进行交换6JT/T1225.2—2018Web服务接口API方法A.1总体要求数据交换的通信数据应采用UTF-8编码。服务API接口的调用应有安全认证机制，以防范未授权A.2静态数据交换APIA.2.1静态数据变化通知APIA.2.1.1功能A.2.1.2方法静态数据变化通知API的参数列表和应答数据格式分别见表A.1和表A.2。参数约束默认值说明及要求output可选返回的数据格式，值域为：json-JSON格式；xml-XML格式必选无通知的流水号，用于多个通知与返回的对应，1～10000的连续数字必选无发生变化的数据表标识字段类型说明及要求status整型返回的状态码，值域：0-正常；1-错误整型返回相应的通知流水号A.2.1.3示例“/jtsjbh/v1/?output=json&lsh=1&data_table_id=nhjc_nhcb_jgxx”。status:0,图A.1静态数据变化通知API的应答JSON格式数据包示例7JT/T1225.2—2018A.2.2.1功能A.2.2.2方法静态数据请求API的参数列表和应答数据格式分别见表A.3和表A.4。表A.3静态数据请求API的参数列表参数约束默认值说明及要求output可选返回的数据格式，值域为：json-JSON格式；xml-XML格式必选无请求的流水号，用于多个请求与返回的对应，从1～10000的连续数字必选无请求的数据表IDrange可选请求的数据范围，值域：all-返回整个数据表；change-只返回发生变化的部分字段类型说明及要求整型返回调用状态码，值域：0-正常；1-错误整型返回相应的请求流水号整型分包数，即一次请求的数据可以分多个包发送bxh整型分包序号，从1开始整型本次返回的记录条数result 本次返回的数据，包含多条记录A.2.2.3示例“/jtsj/vl/?output=json&lsh=1&data_table_id=nhjc_nhcb_jgxx&range=change”。静态数据请求API的应答JSON格式数据包示例如图A.2所示。该示例返回两条发生变化的A.3动态数据交换APIA.3.1功能动态数据交换API的参数列表和应答数据格式分别见表A.5和表A.6。8JT/T1225.2—2018status:0,fbs:1bxh:1,jlts:2,result:{JGID:“×××1”,JGMC:“XX×1”JGLXDM:“×××1”,SUIGID:“×××1”JGID:“X×X2”JGMC:“×××2”,JGLX:“×××2”,SJJGID:“×××2”,表A.5动态数据交换API的参数列表参数约束默认值说明及要求可选返回的数据格式，值域为：json-JSON格式；xml-XML格式必选无请求的流水号，用于多个请求与返回的对应，1～10000的连续数字必选无请求交换的数据表标识可选无船舶识别号，请求数据时，以船舶识别号作为查询关键词，如果无该参数，则查询所有船舶可选无入库时间，请求数据时，以大于某个入库时间为条件查询，如果无该参数，则入库时间不受限制可选无请求交换的记录条数表A.6动态数据交换API的应答数据格式字段类型说明及要求status整型返回调用状态码，值域：0-正常：1-错误整型返回请求的流水号9JT/T1225.2—2018表A.6(续)字段类型说明及要求整型分包数，即一次请求的数据可以分多个包发送bxh整型分包序号，从1开始整型该包的记录条数result—本次返回的数据，包含多条记录“/dtsj/v1/?output=json&lsh=1&data_table_id=nhjc_nhcb_dcnyxhl&cbsbh=1234567890123&rksj=2017/8/110:10:00&jlts=2”。status:0,lsh:1.fbs:1bxh:1,jlts:2,result:{CBSBH:“X××1”HXLC:“×××1”,NYXHL:“×××1”,SJZHL:“×××1”CBSBH:“XX×2”HXIC:“X××2”.NYXHL:“×××2”,SJZHL:“×××2”}A.4周期汇总数据交换APIA.4.1功能JT/T1225.2—2018A.4.2方法周期汇总数据交换API的参数列表和应答数据格式分别见表A.7和表A.8。表A.7周期汇总数据交换API的参数列表参数约束默认值说明及要求output可选xml输出格式为json或者xml必选无请求的流水号，用于多个请求与返回的对应，1～10000的连续整数必选无请求交换的数据表标识cbsbh可选无船舶识别号，如果无该参数，则查询所有船舶hzsjfldm可选无汇总时间分类代码，如果无该参数，则查询所有汇总周期类型hzqssj可选无汇总起始时间，请求数据时，以某个汇总起始时间为条件查询，如果无该参数，则查询所有汇总起始时间可选无请求交换的记录条数表A.8周期汇总数据交换API的应答数据格式字段类型说明及要求status整型返回调用状态码，值域：0-正常；1-错误整型返回请求的流水号整型分包数，即一次请求的数据可以分多个包发送bxh整型分包序号，从1开始整型该包的记录条数result—本次返回的数据，包含多条记录A.4.3示例“/zqhzsj/vl/?output=json&lsh=1&data_table_id=nhjc_nhcb_denyxhlhz&cbsbh=1234567890123&hzsjfldm=3&hzqssj=2017/8/100:00:00&jlts=2”。JT/T1225.2—2018{bxh:1,result:{CBSBH: