JT-T-1257.3-2019营运货车能耗在线检测第3部分：数据交换

ICS03.220.40;35.240.60JT/T1257.3—2019营运货车能耗在线监测第3部分：数据交换Onlineenergyconsumptionmonitoringforcommercialvehicleforcargos2019-03-15发布JT/T1257.3—2019 Ⅱ 1 13术语和定义、缩略语 1 25数据交换格式 2 9 9附录A(规范性附录)Web服务接口API方法 IⅡ——第1部分：数据采集设备技术要求；本部分为JT/T1257的第3部分。本部分按照GB/T1.1—2009给出的规则起草。本部分由交通运输信息通信及导航标准化技术委员会提出并归口。1JT/T1257.3—2019营运货车能耗在线监测GB16735道路车辆车辆识别代码(VIN)JT/T697.1交通信息基础数据元第1部分：总则JT/T697.7—2014交通信息基础数据元第7部分：道路运输信息基础数据元JT/T415—2006道路运输电子JT/T808道路运输车辆卫星定位系统终端通信协议及数据格式3.1术语和定义3.1.13.1.2上级机构supervisingauthority3.2缩略语2JT/T1257.3—2019UTF-8——8位统一码转换格式(8-bitUnicodeTransformationFormat)JT/T697.1的规定。序号信息分类数据表名称数据表标识1静态机构信息nhjc_yyhe_jgxx设备所属机构的基本信息2数据采集设备信息nhjc_yyhe_sjcjsbxx不同数据采集设备类型的相关信息3船舶信息nhjc_yyhe_clxx车辆的基本信息4动态车辆能耗信息nhjc_yyhc_clnhxx数据采集设备定时上传到平台的车辆能耗信息5车辆能源增加明细信息nhjc_yyhc_clnyzjmx车辆能耗信息中剩余能源量信息计算得到的能源增加量、能源增加时间和能源增加地点6信息nhjc_yyhc_clzxhmx车辆能耗信息中载荷信息计算得到的车辆装货或卸货时间、地点和重量等明细信息7车辆货运趟次明细信息nhjcyyheclhytcmx车辆装卸货明细计算得到的每一趟次车辆装货信息、卸空货信息、载运行程、货运量、货物周转量等明细信息8车辆能源增加量汇总信息以年、季度、月或日不同频率对车辆能源增加量的定期汇总9周期汇总信息车辆能源消耗量汇总信息以年、季度、月或日不同频率对车辆能源消耗量的定期汇总信息nhjc_yyhe_clhylhz以年、季度、月或日不同频率对车辆货运量的定期汇总序号数据类型数据格式说明及要求1机构统一社会信用代码TYSHXYDM字符型n18见GB32100—20152机构名称JGMC字符型an..100及其他依法成立的单位的名称3上级机构统一社会信用代码SJJGTYSHXYDM字符型n18上级机构的统一社会信用代码，如无上级机构则为空3JT/T1257.3—2019序号数据类型数据格式说明及要求1设备生产厂商统一社会信用代码TYSHXYDM字符型n18见GB32100—20152设备型号SBXH字符型an..40数据采集设备的型号3设备IDSBID字符型an..30唯一标识数据采集设备的符号4设备固件版本号SBGJBBH字符型an..100数据采集设备模块的固件版本号5车辆识别代码CLSBDM字符型n17见GB167356设备入网日期SBRWRQ字符型YYYYMMDDhhmmss数据采集设备中第一次按照JT/T808通信协议向平台注册成功的序号数据类型数据格式说明及要求1车辆识别代码CLSBDM字符型n17见GB16735中3.12车型结构代码CXJGDM字符型(含冷藏保温车);9-其他3车辆(挂车)号牌CLHP字符型an..12见JT/T697.7—2014中4车牌颜色代码CPYSDM字符型见JT/T697.7—2014中5车辆(挂车)吨位CLDW数字型n..9,2见JT/T697.7—2014中16车辆箱位CLXW数字型n..6见JT/T697.7—2014中27车辆罐体容积CLGTRJ数字型n..6,2见JT/T697.7—2014中38车辆出厂日期CLCCRQ日期型YYYYMMDD见JT/T697.7—2014中79车辆车长CLCC数字型n..6见JT/T697.7—2014中3道路运输证号DLYSZH字符型n12见JT/T415—2006中5.4.1代码CLNYLXDM字符型气(LNG);4-压缩天然气(CNG);5-液化石油气(LPG);6-双燃料；7-纯电动；8-混合动力；9-其他4JT/T1257.3—2019序号数据类型数据格式说明及要求油箱总容积YXRJ数字型n..6各油箱容积之和，当车辆能源类储气罐容积CQGRJ数字型n..6当车辆能源类型为气时须填写，单位：m³电池容量DCRL数字型n..6,1当车辆能源类型为电时须填写，单位：kW·h经营业户名称JYYHMC字符型an..100指拥有该车辆经营权的企业或个体经营户的名称经营业户类型代码JYYHLXDM字符型值域：1-企业；2-个体经营业户社会信用代码SHXYDM字符型an..18见GB32100—2015范围JYYHJYFW字符型a..500见JT/T697.7—2014日常管理机构行政区划代码RCGLJGXZQHDM字符型车辆日常管理机构所在地行政区划代码，见GB/T2260道路运输证签发机构名称DYYSZQFJGMC字符型an..100道路运输证签的管理机构名称道路运输证签发机构行政区划代码DYYSZQFJGXZQHDM字符型道路运输证的管理机构所在地行政区划代码，见GB/T2260序号数据类型数据格式说明及要求1车辆识别代码CLSBDM字符型n17见GB16735中3.12采集时间CJSJ日期时间型YYYYMMDDhhmmss数据采集设备采集时的北京时间3经度JINGDU数字型n..9,6数据采集时车辆位置的经度，单位：°4纬度WEIDU数字型n..9,6数据采集时车辆位置的纬度，单位：°5高程GAOCHENG数字型n..4,1单位：m6速度SUDU数字型n..4,1单位；km/h5JT/T1257.3—2019表5(续)序号数据类型数据格式说明及要求7方向FANGXIANG数字型n..3数据采集时的车辆方向。值域：0～360,单位：°8里程LICHENG数字型n..8,1从车辆安装数据采集设备开始行驶里程合计，单位；km9瞬时能源消耗量SSNYXHL数字型n..6,1油单位：L/h;气单位：kg/h;电单位；kW·h累计能源消耗量LJNYXHL数字型n..10,1油单位：L/h;气单位：kg/h;电单位；kW·h剩余能源量SYNYL数字型n..6.1载质量ZZL数字型n..10,2单位：t剩余能源量模数转换值SYNYLMSZHZ数字型n..10,1正整数载质量模数转换值ZCLMSZHZ数字型n..10,1正整数ACC状态ACCZT字符型数据采集时车辆ACC所处状态。值域：0-关；1-开卫星定位状态WXDWZT字符型数据采集时，车载终端设备的定位状态。值域：0-未定位；1-定位序号数据类型数据格式说明及要求1记录IDJLID字符型an..40唯一标识一条车辆能源增加明细信息的符号2车辆识别代码CLSBDM字符型n17见GB16735中3.13能源增加结束时间NYZJSK日期时间型YYYYMMDDhhmmss增加能源结束时的北京时间4能源增加地点名称NYZJDDMC字符型an..100增加能源(加油或加气或充电)结束时的地点名称5经度JINGDU数字型n..9,6数据采集时车辆位置的经度，单位：6纬度WEIDU数字型n..9,6数据采集时车辆位置的纬度，单位：°7能源增加量NYZJL数字型n..5,1油单位：L;气单位：kg;电单位：6JT/T1257.3—20195.6车辆装卸货明细信息车辆装卸货明细信息数据交换格式见表7。表7车辆装卸货明细信息数据交换格式序号数据类型数据格式说明及要求1记录IDJLID字符型an..40唯一标识一条装卸货明细信息的符号2车辆识别代码CLSBDM字符型n17见GB16735中3.13装货时间ZHSJ日期时间型YYYYMMDDhhmmss装货结束时的北京时间4卸货时间XHSJ日期时间型YYYYMMDDhhmmss卸货结束时的北京时间5装卸货地点名称ZXHDDMC字符型an..100装卸货结束时的地点名称6经度JINGDU数字型n..9,6车辆装卸货结束时位置的经度，单位：°7纬度WEIDU数字型n..9,6车辆装卸货结束时位置的纬度，单位：°8装货质量ZHZL数字型n..6,2若是卸货事件，该字段为空9卸货质量XHZL数字型n..6,2若是装货事件，该字段为空5.7车辆货运趟次明细信息车辆货运趟次明细信息数据交换格式见表8。表8车辆货运趟次明细数据交换格式序号数据类型数据格式说明及要求1记录IDJLID字符型an..40唯一标识一条货运趟次明细信息的符号2车辆识别代码CLSBDM字符型nl7见GB16735中3.13装货时间ZHSJ日期时间型YYYYMMDDhhmmss车辆装货结束时的北京时间4装货地点名称ZHDDMC字符型an..100每一趟次的起始地点名称5装货质量ZHZL数字型n..6,2单位：t6卸货时间XKSJ日期时间型YYYYMMDDhhmmss车辆卸货结束时的北京时间7卸空地点名称XKDDMC字符型an..1008载运行程ZYXC数字型n..6,1装货运行里程7JT/T1257.3—2019表8(续)序号数据类型数据格式说明及要求9载运时长ZYSC数字型n..6,1装货运行时长，单位；h经度JINGDU数字型n..9,6车辆装卸货结束时位置的经度，单位：°纬度WEIDU数字型n..9,6车辆装卸货结束时位置的纬度，单位：°序号数据类型数据格式说明及要求1记录IDJLID字符型an..40唯一标识一条车辆能源增加汇总信息的符号2车辆识别代码CLSBDM字符型nl7见GB16735中3.13汇总时间分类代码HZSJFLDM字符型月汇总；4-日汇总4开始时间KSSJ日期时间型YYYYMMDDhhmmss汇总期开始时间5结束时间JSSJ日期时间型YYYYMMDDhhmmss汇总期结束时间6能源增加次数NYZJCS数字型n..5汇总期内车辆增加能源(加油或加气或充电)的次数，单位：次7能源增加量NYZJL数字型n..16,1汇总期内车辆各次能源增加量的位：kW·h序号数据类型数据格式说明及要求1记录IDJLID字符型an..40唯一标识一条装卸货明细信息的符号2车辆识别代码CLSBDM字符型n17见GB16735中3.18JT/T1257.3—2019表10(续)序号数据类型数据格式说明及要求3汇总时间分类代码HZSJFLDM字符型月汇总；4-日汇总4开始时间KSSJ日期时间型YYYYMMDDhhmmss汇总期开始时间5总行程ZXC数字型n..16,1汇总期内车辆行驶总里程，单位：km6载运行程ZYXC数字型n..16,1汇总期内车辆载运行总里程，单位：km7货运量HYL数字型n..17,2汇总期内车辆实际运送的货物总质量，单位：t8货物周转量HWZZL数字型n..17,2汇总期内实际运送的每趟次货物质量分别乘其载运行程的累计数，单位：t·km9能源消耗量NYXHL数字型n..4,1汇总期内的能源消耗累计值。百吨公里能源消耗量BDCLNYXHL数字型n..4,1单位：kgce/(100t·km)5.10车辆货运量汇总信息车辆货运量汇总信息数据交换格式见表11。表11车辆货运量汇总信息数据交换格式序号数据类型数据格式说明及要求1记录IDJLID字符型an..40唯一标识一条车辆货运量汇总信息的符号2车辆识别代码CLSBDM字符型n17号，它根据国家车辆管理标准确定，包含了车辆的生产厂家、年代、车3汇总时间分类代码HZSJFLDM字符型月汇总；4-日汇总4开始时间KSSJ日期时间型YYYYMMDDhhmmss汇总期开始时间9JT/T1257.3—2019表11(续)导学能耗并科能耗测分究院为要求5刘燕能TCS能由科n..5提按设监交平从信始寿据人王灵据于规的位完整过及规能崔6工作交集GZCR能由科n..5,1单GB/T21393—2008要求数照则起7按车及ZXC能由科n..16,1提按设监交平车驶按里及，技出：km8里数车及ZYXC能由科n..16,1提按设监交平里数车按里及，技出：km9据数崔HYL能由科n..17,2提按设监交平实际数送规据于按质崔，技出：t据于会息崔HWZZL能由科n..17,2提按设监实际数送规归刘燕据于质崔术本乘备里数车及规累应能，技出：t·km方口营运能耗在线主第Web服给航标API个部，详单附输A。A.2.1.2功分A.2.1.2耗在其最能要求output行选xml返回的定了货车。值域：json-JSON货车；xml-XML货车进选无方知的流水仅，线监注日方知与返回的台之。1～10000的连续定共data_table_id进选无发生变化的定了用对格其最能要求status整引返回的状不容。值域：0-正常；1-错误整引返回包之的方知流水仅A.2.1.3是例“/jtsjbh/vl/?output=json&lsh=1&data_table_id=nhjc_nhcb_jgxx”。JT/T1257.3—2019}图A.1机构数据容格式信API息应答JSON换表数据包示例A.2.2机构数据请内APIA.2.2.1事能A.2.2.2方法静态数据请消API的参数列表和应答数据格式分别见表A.3和表A.4。交A.3机构数据请内API息参数列交说明及月消output可选xml返回的数据格式。团体：json-JSON格式；xml-XML格式必选求请消的流水号，用于多个请消与返回的对应。从1～10000的连如数字data_table_id必选求请消的数据表IIrange可选请消的数据范围。团体：all-返回整个数据表；change-只返回发企变立的部分交A.4机构数据请内API息应答数据换表说明及月消status整型返回调用状态码。团体：0-正常；1-错误整型返回相应的请消流水号整型分包数，即一次请消的数据可以分多个包发送bxh整型分包序号，从1开始整型本次返回的记录条数result本次返回的数据，包依多条记录A.2.2.3示例静态数据请消API的URL示例要下：“/jtsj/v1/?output=json&lsh=1&data_table_id=nhjc_nhcb_jgxx&range=change”。静态数据请消API的应答JSON格式数据包示例见图A.2。无示例返回两条发企变立的记录。JT/T1257.3—2019{SJJGID:“XXX1”}}}A.3动态数据交换APIA.3.1功能A.3.2方法动态数据交换API的参数列表和应答数据格式分别见表A.5和表A.6。表A.5动态数据交换API的参数列表说明及要求output可选xml返回的数据格式。值域：json-JSON格式；xml-XML格式必选无请求的流水号，用于多个请求与返回的对应。1～10000的连续数字data_table_id必选无请求交换的数据表标识CLSBDM可选无车辆识别代码，请求数据时，以车辆识别代码作为查询关键词，如果无该参数，则查询所有车辆rksj可选无入库时间，请求数据时，以大于某个入库时间为条件查询，如果无该参数，则入库时间不受限制可选无请求交换的记录条数JT/T1257.3—2019说明及消要京型质正始用置态码。唯模：0-北油；1-处未京型京型分包数，即一次驶要的数据可以分多个包气里京型分包序号，合1开续京型域包的记录纬数本次质正的数据，包值多纬记录“/dtsj/v1/?output1234567890123&rksj=2017/8/110:10:00&jlts=json&lsh=1&data_table_id=nhjc_nhcb_denyxhl&cbsbh==2”。com)、安务名(dtsj)、安务版本号(v1)组成；“?”从充是驶要累数，“&”是累数分隔符。{HXLC:“XXX1”,NYXHL:“XXXI”,SJZHL:“XXX1”HXLC:“XXX2”,NYXHL:“XXX2”,SJZHL:“XXX2”}}}JT/T1257.3—2019A.4.1功能数据请求方向数据提供方发送周期汇总数据请求，数据提供方收到该请求后返回相应的周期汇总数据。A.4.2方法周期汇总数据交换API的参数列表和应答数据格式分别见表A.7和表A.8。表A.7周期汇总数据交换API的参数列表说明及要求output可选xml输出格式为json或者xml必选无请求的流水号，用于多个请求与返回的对应。1～10000的连续整数data_table_id必选无请求交换的数据表标识CLSBDM可选无车辆识别代码，如果无该参数，则查询所有车辆hzsjfldm可选无汇总时