JT-T-1257.3-2019營運貨車能耗在線檢測第3部分：數據交換

ICS03.220.40;35.240.60JT/T1257.3—2019營運貨車能耗在線監(jiān)測第3部分：數據交換Onlineenergyconsumptionmonitoringforcommercialvehicleforcargos2019-03-15發(fā)布JT/T1257.3—2019 Ⅱ 1 13術語和定義、縮略語 1 25數據交換格式 2 9 9附錄A(規(guī)范性附錄)Web服務接口API方法 IⅡ——第1部分：數據采集設備技術要求；本部分為JT/T1257的第3部分。本部分按照GB/T1.1—2009給出的規(guī)則起草。本部分由交通運輸信息通信及導航標準化技術委員會提出并歸口。1JT/T1257.3—2019營運貨車能耗在線監(jiān)測GB16735道路車輛車輛識別代碼(VIN)JT/T697.1交通信息基礎數據元第1部分：總則JT/T697.7—2014交通信息基礎數據元第7部分：道路運輸信息基礎數據元JT/T415—2006道路運輸電子JT/T808道路運輸車輛衛(wèi)星定位系統終端通信協議及數據格式3.1術語和定義3.1.13.1.2上級機構supervisingauthority3.2縮略語2JT/T1257.3—2019UTF-8——8位統一碼轉換格式(8-bitUnicodeTransformationFormat)JT/T697.1的規(guī)定。序號信息分類數據表名稱數據表標識1靜態(tài)機構信息nhjc_yyhe_jgxx設備所屬機構的基本信息2數據采集設備信息nhjc_yyhe_sjcjsbxx不同數據采集設備類型的相關信息3船舶信息nhjc_yyhe_clxx車輛的基本信息4動態(tài)車輛能耗信息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當車輛能源類型為氣時須填寫，單位：m3電池容量DCRL數字型n..6,1當車輛能源類型為電時須填寫，單位：kW·h經營業(yè)戶名稱JYYHMC字符型an..100指擁有該車輛經營權的企業(yè)或個體經營戶的名稱經營業(yè)戶類型代碼JYYHLXDM字符型值域：1-企業(yè)；2-個體經營業(yè)戶社會信用代碼SHXYDM字符型an..18見GB32100—2015范圍JYYHJYFW字符型a..500見JT/T697.7—2014日常管理機構行政區(qū)劃代碼RCGLJGXZQHDM字符型車輛日常管理機構所在地行政區(qū)劃代碼，見GB/T2260道路運輸證簽發(fā)機構名稱DYYSZQFJGMC字符型an..100道路運輸證簽的管理機構名稱道路運輸證簽發(fā)機構行政區(qū)劃代碼DYYSZQFJGXZQHDM字符型道路運輸證的管理機構所在地行政區(qū)劃代碼，見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(續(xù))序號數據類型數據格式說明及要求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狀態(tài)ACCZT字符型數據采集時車輛ACC所處狀態(tài)。值域：0-關；1-開衛(wèi)星定位狀態(tài)WXDWZT字符型數據采集時，車載終端設備的定位狀態(tài)。值域：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(續(xù))序號數據類型數據格式說明及要求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(續(xù))序號數據類型數據格式說明及要求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(續(xù))導學能耗并科能耗測分究院為要求5劉燕能TCS能由科n..5提按設監(jiān)交平從信始壽據人王靈據于規(guī)的位完整過及規(guī)能崔6工作交集GZCR能由科n..5,1單GB/T21393—2008要求數照則起7按車及ZXC能由科n..16,1提按設監(jiān)交平車駛按里及，技出：km8里數車及ZYXC能由科n..16,1提按設監(jiān)交平里數車按里及，技出：km9據數崔HYL能由科n..17,2提按設監(jiān)交平實際數送規(guī)據于按質崔，技出：t據于會息崔HWZZL能由科n..17,2提按設監(jiān)實際數送規(guī)歸劉燕據于質崔術本乘備里數車及規(guī)累應能，技出：t·km方口營運能耗在線主第Web服給航標API個部，詳單附輸A。A.2.1.2功分A.2.1.2耗在其最能要求output行選xml返回的定了貨車。值域：json-JSON貨車；xml-XML貨車進選無方知的流水僅，線監(jiān)注日方知與返回的臺之。1～10000的連續(xù)定共data_table_id進選無發(fā)生變化的定了用對格其最能要求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方法靜態(tài)數據請消API的參數列表和應答數據格式分別見表A.3和表A.4。交A.3機構數據請內API息參數列交說明及月消output可選xml返回的數據格式。團體：json-JSON格式；xml-XML格式必選求請消的流水號，用于多個請消與返回的對應。從1～10000的連如數字data_table_id必選求請消的數據表IIrange可選請消的數據范圍。團體：all-返回整個數據表；change-只返回發(fā)企變立的部分交A.4機構數據請內API息應答數據換表說明及月消status整型返回調用狀態(tài)碼。團體：0-正常；1-錯誤整型返回相應的請消流水號整型分包數，即一次請消的數據可以分多個包發(fā)送bxh整型分包序號，從1開始整型本次返回的記錄條數result本次返回的數據，包依多條記錄A.2.2.3示例靜態(tài)數據請消API的URL示例要下：“/jtsj/v1/?output=json&lsh=1&data_table_id=nhjc_nhcb_jgxx&range=change”。靜態(tài)數據請消API的應答JSON格式數據包示例見圖A.2。無示例返回兩條發(fā)企變立的記錄。JT/T1257.3—2019{SJJGID:“XXX1”}}}A.3動態(tài)數據交換APIA.3.1功能A.3.2方法動態(tài)數據交換API的參數列表和應答數據格式分別見表A.5和表A.6。表A.5動態(tài)數據交換API的參數列表說明及要求output可選xml返回的數據格式。值域：json-JSON格式；xml-XML格式必選無請求的流水號，用于多個請求與返回的對應。1～10000的連續(xù)數字data_table_id必選無請求交換的數據表標識CLSBDM可選無車輛識別代碼，請求數據時，以車輛識別代碼作為查詢關鍵詞，如果無該參數，則查詢所有車輛rksj可選無入庫時間，請求數據時，以大于某個入庫時間為條件查詢，如果無該參數，則入庫時間不受限制可選無請求交換的記錄條數JT/T1257.3—2019說明及消要京型質正始用置態(tài)碼。唯模：0-北油；1-處未京型京型分包數，即一次駛要的數據可以分多個包氣里京型分包序號，合1開續(xù)京型域包的記錄緯數本次質正的數據，包值多緯記錄“/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功能數據請求方向數據提供方發(fā)送周期匯總數據請求，數據提供方收到該請求后返回相應的周期匯總數據。A.4.2方法周期匯總數據交換API的參數列表和應答數據格式分別見表A.7和表A.8。表A.7周期匯總數據交換API的參數列表說明及要求output可選xml輸出格式為json或者xml必選無請求的流水號，用于多個請求與返回的對應。1～10000的連續(xù)整數data_table_id必選無請求交換的數據表標識CLSBDM可選無車輛識別代碼，如果無該參數，則查詢所有車輛hzsjfldm可選無匯總時