DB32-T 4983-2024 城市公共交通数据接口规范

城市公共交通数据接口规范江苏省市场监督管理局发发出布版IDB32/T4983—2024 Ⅲ 12规范性引用 1 14符号和缩略语 14.1符号 14.2缩略语 2 25.1通则 25.2架构要求 2 26.1入网机构 26.2城市客运企业 6.3社会合作企业 6.4行业主管部门 22附录A(规范性)符号定义 29附录B(规范性)商户类型定义 Ⅲ木文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由江苏省交通运输厅提出、归口并组织实施。木文件起草单位：江苏交通一卡通有限公司、江苏省交通运输厅、江苏省交通通信信息中心、南京公共交通(集团)有限公司、南京市市民卡有限公司、南京熊猫信息产业有限公司、南京通用电器有限公司、连云港海通市民一卡通有限公司。张鹏、丁文权、朱晓雯。1DB32/T4983—2024城市公共交通数据接口规范本文件规定了公共交通数据交换接口的总体要求、数据组成等内容及要求。本文件适用于行业管理机构、各城市一卡通(市民卡)公司、各城市公共交通运输企业和从事城市客运服务的互联网企业等进行信息系统建设和数据交换、数据管理等。2规范性引用下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T2261.4个人基本信息分类与代码第4部分：从业状况(个人身份)代码GB/T11714—1997全国组织机构代码编码规则GB/T17798—2007地理空间数据交换格式GB/T32852.1—2016城市客运术语第1部分：通用术语CH/Z9010—2011地理信息公共服务平台地理实体与地名地址数据规范GA/T2000.156—2016公安信息代码第156部分：常用证件代码JT/T978.4—2023城市公共交通IC卡技术规范第4部分：信息接口JT/T1179—2018交通一卡通二维码支付技术规范3术语及定义JT/T1179—2018界定的以及下列术语和定义适用于本文件。城市公共交通Publictransit运用公共汽车电车、城市轨道交通、城市客运轮渡、共享交通工具等运载工具和相关设施，为城市及邻近区域公众提供基本出行服务。客运企业Passengertransportcompany从事客运服务的企业，它们的主要工作是承担城市、城镇和城乡客运基本服务。4符号和缩略语4.1符号附录A的符号适用于本文件。24.2缩略语下列缩略语适用丁本文件。FTP:文木传输协议(FileTransferProtocol)Json:数据交换格式(JavaScriptObjectNotation)MCC:商户类别码(MerchantCategoryCode)OD:起源目的地(OriginDcstination)Utf-8:编码方式(8位元，UniversalCharacterSet/UnicodeTransformationFormat)VPN:虚拟专用网络(VirtualPrivateNetwork)5总体要求本文件中，除特殊说明外，文件应采用TXT文本格式，文件整休包含文件说明区、交易头及交易数据体(数据内容),文件编码应为UTF-8,文件内部应采用换行作为行分隔符。本文件中的车辆实时运行信息为准实时数据，采用报文接口方式，数据传输间隔应为10s,其余数据接口均采用顺序文件结构方式。行业主管部门通过FTP方式存取文件。5.2架构要求入网机构、客运企业和社会客运企业向市级数据接收方、市级数据接收方向省级数据接收方以及省级接收方向行业主管部门上传数据的数据接口，应包括文件接口、文件存取方式和通信方式，具体数据接口架构应符合图1的规定。行业主管部门行业主管部门报文接口顺序文件结构文件接口FTP方式流水传输方式信息接口市级数据接收方文件存取方式专线接入方式VPN接入方式通信方式社会合作企业省级数据接收方客运图1数据接口架构图6数据组成6.1入网机构6.1.1客户信息命名规则客户信息列表命名规则见表1。3DB32/T4983—2024数据元说明说明a2日期nn1II:手工，A:自动客户信息列表文件格式见表2。表2客户信息文件体数据元说明说明文件说明区n2回车符S20x0D和0x0A交易头n6取值范围000001~999999nn4包含回车换行：取值范围0001~9999回车符S20x0D和Ox0An8n姓名性别11:男，2:女，3:其他2参见GA/T2000.156—2016脱敏处理，如果无，则以缺省0值填充n2士，08:其他脱敏处理，如果无，则以缺省0值填充如果无，则以缺省0值填充4数据元说明数据类型说明指用户交通卡卡号，实体卡和NFC卡卡号不足n201:非交通部标准的卡，02:交通部标准实体卡，0卡，04:交通部标准NFC卡，05:带社保功能的交通部标准二维码，07:交通部标准电子社保码，08:微信二维码，09:支付宝二维码，10:其他非交通部标准二维码保留回车符S2数据元说明说明a2日期nn1表4交易数据明细文件体数据元说明数据类型说明文件说明区n2回车符S2交易头n6取值范围000001~999999nn4包含回车换行：取值范围0001~99995数据元说明说明回车符s2N3参见JT/T978.4—2023A.4,如：3指用户交通卡卡号，实体卡和NFC卡卡号不足N8以分为单位，如地铁进站，则填0;如公交上下均刷卡时，上车填03指示交易的币种，参考国际货币代码，156:人民币交易传输时问N格式为MMddHHmmss交易类型标识211~99:预留6在本交易取得授权时，由发卡机构赋予的授权应答标识N4木交易取得授权的日期，格式为MMDD。由终端机具产生的用于标识一笔交易的。由12位十进制数填写收单机构编码商户类型n4见附录B商户类型定义，如：公共汽(电)车4131由受理终端管理机构分配的受卡方机构标识代码(商户代码、运营单原始交易的日期及时间n不足11位右补空格；由清分结算机构填写n201:离线闸机，02:在线闸机，03:离线车载POS,04:在线车载POS,201:日票(或周票或月票或年票等),02:计次票，03~11:表示每次交易计扣1次，2:表示每次交易计扣2次；11:收单方，2:发卡方，3:平台2参见JT/T978.2—2023,如6数据元说明说明n201:非交通部标准的卡，02:交通部标准实体卡，0卡，04:交通部标准NFC卡，05:带社保功能的交通部标准二维码，07:交通部标准电子社保码，08:微信二维码，09:支付宝二维码，10:其他非交通部标准二维码，11~99:待定6只用于卡交易，为可见的十六进制字符(0~9,A~F),左补0n1n11:上车或进站，2:下车或出站上车(进站)或下车(出n经纬度，格式为"120.123912,31.230293",按照n用于刷卡、扫码或人脸支付的POSID或闸机号用可见的十六进制字符(0~9,A~F),左补0机具交易时间n201:折扣优惠；02:定额优惠；03:03:混合(先打折，后2针对不同交通方式，01:公交打折，02:公交换公交，03:公交换地04:地铁打折，05:地铁换地铁，06:地铁换公交保留使用n1回车符S20x0D和0x0A机构发卡数据命名规则见表5。数据元说明数据类型说明文件标识a2日期n7DB32/T4983—2024数据元说明说明n1机构发卡明细文件格式见表6。表6机构售(开)卡数据文件体数据元说明说明文件说明区n2回车符s2交易头n6取值范围000001~999999nn4包含回车换行：取值范围0001~9999回车符S20xOD和0x0An8nn6交易日期n8交易时间n6用户开卡时间指用户交通卡卡号，实体卡和NFC卡卡号不足20n201:非交通部标准的卡，02:交通部标准实体卡，03:交通部标准异形卡，04:交通部标准NFC卡，05:带社保功能的交通部标准准二维码，07:交通部标准电子社保码，08:微信二维码码，10:其他非交通部标准二维码，11~99:待定2n以分为单位n3机网银，007:云闪付，008:数字人民币，08数据元说明数据类型说明保留n1回车符s20x0D和0x0A机构充值数据命名规则见表7。表7机构充值数据文件头数据元说明说明a2口期nn1机构充值数据接口格式见表8。表8机构充值数据文件体数据元说明说明文件说明区n2回车符S20x0D和0x0A交易头n6取值范围000001~999999nn4回车符s20x0D和0x0A9数据元说明说明n8nn6参见GB/T2260,如320100交易日期n8交易时间n6用户充值时间指用户交通卡卡号，实休卡和NFC卡卡号不足2n8以分为单位n3n201:线上，02:线下，03:白助保留n1回车符S20x0D和0x0A机具信息命名规则见表9。表9机具信息文件头数据元说明数据类型说明a2日期nn文件标志1机具信息文件格式见表10。表10机具信息文件体数据元说明说明文件说明区n2回车符s20x0D和0x0A交易头n6取值范围000001~999999nn4包含回车换行：取值范围0001~9999回车符S2n8nn6参见GB/T2260,如320100见附录B商户类型定义中客运方式，如：轨道交通商户类型n4见附录B商户类型定义中MCC码，如公共汽(电)车4131n公交填所属线路名，地铁填所属站点名n用于刷卡、扫码或人脸支付的POS号(或闸机号)n201:一票制，02:多级票制n201:改造，02:新增N2N201:介质，02:WLAN,03:3G,04:4G,05:5G保留回车符S26.2城市客运企业客运公司信息命名规则见表11。DB32/T4983—2024表11客运公司信息文件头数据元说明说明a2日期nn1II:手工，A:自动客运公司信息文件格式见表12。表12客运公司信息文件体数据元说明说明文件说明区n2回车符S2交易头n6nn4回车符s20xOD和Ox0An8nn6商户类型n4见附录B商户类型定义中MCC码，如公共汽(电)车41316n6联系人姓名表12客运公司信息文件体(续)数据元说明数据类型说明参见GA/T2000.156—2016,脱敏处理，不n保留回车符S2营运线路命名规则见表13。表13营运线路文件头数据元说明数据类型说明a2日期nn文件标志1营运线路文件格式见表14。表14营运线路文件体数据元说明说明文件说明区n2回车符S20x0D和0x0A交易头n6取值范围000001~999999nn4包含回车换行：取值范围0001~9999回车符S2n8数据元说明数据类型说明n4见附录B商户类型定义中MCC码，如公共汽(电)车4131nn6n2地铁，01:正常，02:区间，03:环线；n2nn4n201:折扣率，02:定额，03:混合(先打折，后减定额),n2针对不同交通方式，01:公交打折，02:公交换04:地铁打折，05:地铁换地铁，06:地铁换公交，07~99:待定优惠折扣率(值)n6针对不同优惠类型。折扣率：如8折，填80;折扣值100;混合优惠时，前三位表示折扣率，后三位表示优惠金额。n2n4n6n4n4n4保留回车符S2数据元说明数据类型说明文件标识a2日期n表15车辆信息文件头(续)数据元说明说明n1车辆信息文件格式见表16。表16车辆信息文件体数据元说明说明文件说明区n2回车符s2交易头n6取值范围000001~999999nn4回车符S2n8nn6商户类型n4见附录B商户类型定义中MCC码，如公共汽(电)车4131车辆类别客：单层大型、单层中型、单层小型，交通工具编号n2n4n仅对公交，用于刷卡、扫码或人脸支付的POSID;地以缺省值0填充n2仅对公交；地铁和有轨电车等以缺省值0填充DB32/T4983—2024表16车辆信息文件体(续)数据元说明数据类型说明n2仅对公交，01:介质，02:WLAN,03:3G,04:4G,05:5G,定；地铁和有轨电车等以缺省值0填充n2仅对公交，01:卡，02:码，03:卡+码，04:卡+码+人电车等以缺省值0填充保留回车符S20x0D和0x0A线路站点信息命名规则见表17。表17站点信息文件头数据元说明数据类型说明a4日期nn文件标志1站点信息文件格式见表18。表18站点信息文件体数据元说明数据类型说明文件说明区n2回车符S2交易头n6nn4回车符s2表18站点信息文件体(续)数据元说明数据类型说明n11:上行，2:下行，3:内环，4:外环，5:双向循环，6:单向循环，7:其他n33从001开始格式为"120.123912,31.230293",按照中国国测局地理坐标(GCJ-02)22…3格式为"120.123912,31.230293",按照中国国测局地理坐标(GCJ-02)n2仅对地铁和有轨电车，01:卡，02:码，03:卡+码，04:卡+码保留回车符S2实时车辆运行信息接口定义见表19。表19实时车辆运行信息接口定义车辆实时运行信息由运营公司上送车辆实时信息http://xxx.xxxxxxxx.xxx/vehicle/runTi表19实时车辆运行信息接口定义(续)实时车辆运行信息请求报文格式见表20。表20实时车辆运行信息请求报文说明nn交通工具编号1"120.123912,31.230293",按照中国国测局地理坐标(GCJ-02)4速度，单位千米每小时(km/h)方位角5时间(24h时间):yyyyMMddHHmmss4站点序号，从1开始当前经过的站点编号到离站标识21:到站，2:离站，3:其他营运机构对站点的编号营运状态计划发车时间(24h时间):yyyyMMddHHmmss保留回车符s20x0D和0x0AOD数据文件命名规则见表21。表21OD数据文件头DB32/T4983—2024数据源说明数据类型说明文件标识a3日期nOD数据文件格式见表22。表22OD数据文件体数据源说明说明交易头n左补0回车符n20x0D和0x0A指用户交通卡卡号，实休卡和NFC卡卡号不足交易时间nn8n格式为"120.123912,31.230293",按照中国国测局地理坐标(GCJ-02)下车(出站)站点编号n下车(出站)站点名称下车(出站)站点经纬度保留回车符S26.3社会合作企业出租车(含网约车)企业数据命名规则见表23。表23出租车(含网约车)企业数据文件头DB32/T4983—2024数据元说明数据类型说明a2日期nn文件标志1出租车(含网约车)企业数据文件格式见表24。表24出租车(含网约车)企业数据文件体数据元说明说明文件说明区n2回车符S20xOD和0x0A交易头n6取值范围000001~999999nn4回车符s2空格，二维码虚拟卡号不足的右补Fnn6参见GB/T2260,如320100下车地点所属城市代码n6交通工具类型4见附录B商户类型定义中MCC码，如公共汽(电)车4131交通工具编号上车时间格式为"120.123912,31.230293",按照中下车时间下车地点名称表24出租车(含网约车)企业数据文件体(续)数据元说明说明下车站点经纬度格式为"120.123912,31.230293",按照中交易日期nn8n4单位：分/公里6格式为“8.5,3”,表示“3公里内为8.5元”n等候时问n6等候费用n8n3001:现金，002:交通卡，003:微信，004:支付转账，006:手机网银，007:云闪付，008:数字人民币，009~n40001:出租车，0002:滴滴，0003:T3,0004:曹操，0005~9999:n201:柴油，02:汽油，03:天然气，04:电车，05:油电，06:氢，07～99:待定公司代码n即数据上传，格式为yyyyMMddHHmmssn回车符s20x0D和0x0A共享单车企业数据命名规则见表25。表25共享单车企业数据文件头数据元说明说明A2日期NN1共享单车企业数据文件格式见表26。表26共享单车企业数据文件体数据元说明说明文件说明区N2回车符S20x0D和0x0A交易头n6取值范围000001~999999nn4包含回车换行：取值范围0001~9999回车符s20x0D和0x0Ann6下车地点所属城市代码n6参见GB/T2260,如320100交通工具类型n201:城市公共自行车，02:共享自行车，03:共享汽车，05～99:待定交通工具编号用车开始时间n用车起点格式为"120.123912,31.230293",按照中用车结束时间n用车结束地点格式为“120.123912,31.230293”n8n单位：km,保留两位小数n3账，006:手机网银，007:云闪付，008:数字人民币，009~999:待定表26共享单车企业数据文件体(续)数据元说明数据类型说明n401:美团，02:哈啰，03:青桔，04~09:待定，车运营A公司，11:城市公共自行车运营B公司，12:城市公共白行车运营C公司，13~99:待定公司代码n即数据上传，格式为yyyyMMddHHmmssn回车符s2本地公共交通发卡情况命名规则见表27。表27本地公共交通发卡发卡情况文件头数据元说明数据类型说明文件标识A3日期N本地公共交通发卡情况文件格式见表28。表28本地公共交通发卡情况文件体数据元说明说明交易头n左补0n左补0回车符s20x0D和0x0A不足11位右补空格；由清分结算机构填写n201:非交通部标准的卡，02:交通部标准实体卡，0卡，04:交通部标准NFC卡，05:带社保功能的交通部标准二维码，07:交通部标准电子社保码，08:微信二维码，09:支付宝二维码，10:其他非交通部标准二维码，11~99:待定DB32/T4983—2024表28本地公共交通发卡情况文件体(续)数据元说明数据类型说明n8回车符S2省内综合交易情况命名规则见表29。表29省内综合交易情况文件头数据源说明数据类型说明a2日期n省内综合交易情况文件格式见表30。表30省内综合交易情况文件体数据源说明说明n左补0,卡+码n左补0,卡+码n左补0n左补0n左补0n左补0n左补0n左补0,卡+码n左补0,卡+码n左补0,卡+码nn左补0n左补0n左补0n左补0n左补0表30省内综合交易情况文件体(续)数据源说明数据类型说明n左补0n左补0n左补0交易量最大机构n6左补0n8左补0回车符S2省内地市互通交易情况命名规则见表31。表31省内地市互通交易情况文件头数据源说明数据类型说明a2日期n省内地市互通交易情况文件格式见表32。表32省内地市互通交易情况文件体数据源说明说明交易头n左补0回车符s20x0D和0x0A交易日期n8n左补0n左补0n左补0DB32/T4983—2024表32省内地市互通交易情况文件体(续)数据源说明说明n回车符S2本地公共交通数据命名规则见表33。表33本地公共交通数据文件头数据源说明数据类型说明a3日期n本地公共交通数据文件格式见表34。表34本地公共交通数据文件体数据源说明说明交易头n左补0回车符S20x0D和0x0A不足11位右补空格；由清分结算机构填写交易日期n8商户类型n4见附录B商户类型定义中MCC码，如公共汽(电)车4131n左补0n左补0n左补0n左补0回车符S20x0D和0x0A木地公共交通数据小时分析文件命名规则见表35。表35本地公共交通数据小时分析文件头数据源说明数据类型说明文件标识a3日期n本地公共交通数据小时分析文件格式见表36。表36本地公共交通数据小时分析文件体数据