T-CSGF 019-2022 二代健身路径集成管理与服务系统信息传输技术规范

ICS97.220CCSY55团体标准T/CSGF019—2022二代健身路径集成管理与服务系统信息传输技术规范Technicalspecificationforinformationtransmissionofintegratedsystemof2022-12-28发布2023-01-10实施中国体育用品业联合会发布IT/CSGF019—2022前言 Ⅲ1范围 12规范性引用文件 13术语和定义 14缩略语 15系统模型 26系统数据接入及上报 27数据接口及参数 5附录A(资料性)数据接入授权和上报 23参考文献 25ⅢT/CSGF019—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由中国体育用品业联合会提出并归口。本文件起草单位:舒华体育股份有限公司、南京万德体育产业集团有限公司、南京体育学院。1T/CSGF019—2022二代健身路径集成管理与服务系统信息传输技术规范1范围本文件规定了二代健身路径集成管理与服务系统(以下简称“系统”)信息传输的系统模型、系统数据接入及上报和数据接口及参数。本文件适用于二代健身路径的器材和设备、用户信息、健身指导和平台间互联的信息传输技术设2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T2260中华人民共和国行政区划代码GB19272—2011室外健身器材的安全通用要求T/CSGF008—2020智慧健身场所信息传输技术规范3术语和定义T/CSGF008—2020界定的以及下列术语和定义适用于本文件。二代健身路径管理子平台managementsub-platformofsecondgenerationofoutdoorfitnessequip-各省市二代健身路径集成管理与服务的信息化系统。3.2基础数据basedata系统中注册的固定信息。3.3运营数据operationdata系统运行中变动的信息。4缩略语下列缩略语适用于本文件。HTTPS:超文本传输安全协议(HyperTextTransferProtocoloverSecureSocketLayer)ID:身份标识码(IdentIty)UTF:统一码转换格式(UnIcodeTransformatIonFormat)DES:数据加密标准(DataEncryptIonStandard)2T/CSGF019—20225系统模型5.1二代健身路径管理子平台(以下简称“子平台”)系统由服务信息系统、管理信息系统组成,模型见图1。图1二代健身路径管理子平台模型5.2服务信息包括用户基本资料、运动数据和健身指导等。5.3管理信息包括二代健身路径场地信息、器材信息、设备信息、厂商信息和维护方数据管理信息等。5.4子平台与全民健身信息服务平台和地方政府部门数据平台按照T/CSGF008进行数据通讯。6系统数据接入及上报6.1接入方式子平台为服务信息和管理信息提供统一的数据接入服务接口,并对接入子平台的数据进行接入授权,经子平台授权验证后,将数据通过服务接口上传。信息数据接入关系见图2,子平台与全民健身信息服务平台关系见图3。3T/CSGF019—2022图2子平台信息数据接入关系图图3全民健身信息服务平台系统数据接入关系图6.2接入安全6.2.1访问安全服务信息和管理信息在子平台进行数据上报前应向子平台申请数据接入授权。审核通过后,获取令牌和密钥等相关参数,方可接入上传数据,接入示例见附录A。各子平台进行数据上报全民健身信息服务平台前应申请数据接入授权。审核通过后,获取令牌和密钥等相关参数,方可接入上传数据,接入示例见附录A。6.2.2数据传输安全数据上报应采用加密方式进行传输,采用所获得的密钥进行对称加密(DES)。6.3数据上报6.3.1基础数据,服务信息和管理信息可按照规范即时调用上报数据接口。6.3.2运营数据,服务信息和管理信息根据可配置的频率上报,上报频率最长时间间隔应小于5mIn。6.4数据管理6.4.1基础数据管理服务信息和管理信息上报的基础数据,经子平台审核确认后保存。各管理系统经子平台授权后,可4T/CSGF019—2022查询获取基础数据。6.4.2运营数据管理服务信息和管理信息的运营数据按相关要求,通过数据接口上报至子平台保存和分析。6.5数据编码6.5.1场地单位性质编码见表1。表1场地单位性质编码编码值编码名称10财政补助事业单位11经费自理事业单位12企业13其他6.5.2设备状态编码见表2。表2设备状态编码编码值编码名称00正常使用01维修中02停止使用6.5.3场地状态编码见表3。表3场地状态编码编码值编码名称00正常开放01装修关闭02活动包场03暂停营业04停止营业6.5.4性别编码见表4。表4性别编码编码值编码名称00男性01女性5T/CSGF019—20226.5.5年龄范围编码见表5。表5年龄范围编码编码值编码名称0116岁以下0216岁~20岁0321岁~25岁0426岁~30岁0531岁~35岁0636岁~40岁0741岁~45岁0846岁~50岁0950岁以上6.5.6证件类型编码见表6。表6证件类型编码编码值编码名称00身份证01护照02军官证03学生证04其他7数据接口及参数7.1二代健身路径场地信息(以下简称“场地信息”)接口及参数7.1.1场地信息注册接口及参数接口名称:RegIstervenueData。场地信息注册输入参数见表7,场地信息注册输出参数见表8。表7场地信息注册输入参数中文名称参数名称说明数据类型约束/条件值域场地名称venueName场地的名字strIngM单位性质venueprop单位性质IntM见表1场地单位性质编码6T/CSGF019—2022表7场地信息注册输入参数(续)中文名称参数名称说明数据类型约束/条件值域场地IDvenueId场地标识号strIngM—状态state场地当前状态strIngM见表3场地状态编码省份IDprovInceId省份标识号IntM按照GB/T2260中的规定执行城市IDcItyId城市标识号IntM按照GB/T2260中的规定执行区县IDdIstrIctId区县标识号IntM按照GB/T2260中的规定执行地址场地位置strIngM地址名称联系人contacts场地联系人strIngM联系人电话contactTel场地联系人电话strIngM法定代表人personIncharge场地的负责人strIngM经度longItude场地位置经纬度strIngM经度纬度latItude场地位置经纬度strIngM纬度用地面积measureArea用地面积strIngM数字,单位为平方米(m2)建筑面积floorage建筑面积strIngM数字,单位为平方米(m2)场地产权单位propRorg场地产权单位strIngM单位名称运营单位operorg运营单位strIngM单位名称上级主管单位上级主管单位strIngM单位名称建成年份buIltyear建成年份strIngM数字,年份投资总额InvAmount投资总额strIngM数字,单位为万元表8场地信息注册输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明7.1.2场地信息更新接口及参数接口名称:syncvenueData。7T/CSGF019—2022场地信息更新输入参数见表9,场地信息更新输出参数见表10o表9场地信息更新输入参数中文名称参数名称说明数据类型约束/条件值域场地IDvenueId场地标识号strIngM 状态state场地当前状态strIngM见表3场地状态编码开放时间busInessTIme场地的开放时间strIngM表10更新输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明7.1.3场地信息查询接口及参数接口名称:syncvenueDataGeto场地信息查询输入参数见表11,场地信息查询输出参数见表12o表11场地信息查询输入参数中文名称参数名称说明数据类型约束/条件值域场地IDvenueId场地标识号strIngM—表12场地信息查询输出参数中文名称参数名称说明数据类型约束/条件值域场地名称venueName场地的名字strIngM单位性质venueprop单位性质IntM见表1场地单位性质编码场地IDvenueId场地标识号strIngM 省份IDprovInceId省份标识号IntM按照GB/T2260中的规定执行城市IDcItyId城市标识号IntM按照GB/T2260中的规定执行区县IDdIstrIctId区县标识号IntM按照GB/T2260中的规定执行8T/CSGF019—2022表12场地信息查询输出参数(续)中文名称参数名称说明数据类型约束/条件值域地址场地位置strIngM地址名称联系人contacts场地联系人strIngM联系人电话contactTel场地联系人电话strIngM法定代表人personIncharge场地的负责人strIngM经度longItude场地位置经纬度strIngM经度纬度latItude场地位置经纬度strIngM纬度用地面积measureArea用地面积strIngM数字,单位为平方米(m2)建筑面积floorage建筑面积strIngM数字,单位为平方米(m2)场地产权单位propRorg场地产权单位strIngM单位名称运营单位operorg运营单位strIngM单位名称上级主管单位上级主管单位strIngM单位名称建成年份buIltyear建成年份strIngM数字,年份投资总额InvAmount投资总额strIngM数字,单位为万元7.1.4场地信息注册、更新状态、查询信息流程场地信息注册、更新状态、查询信息流程见图4。图4二代健身路径场地信息注册、更新状态、查询流程9T/CSGF019—20227.2二代健身路径设备信息(以下简称“设备信息”)接口及参数7.2.1设备信息注册接口及参数接口名称:RegIstersecGenBasIcData。输入参数见表13,输出参数见表14。表13设备信息注册输入参数中文名称参数名称说明数据类型约束/条件值域设备名称FItEquIpment设备的名字strIngM设备IDFItEquIpmentId设备的识号strIngM字符串省份IDprovInceId省份标识号IntM按照GB/T2260中的规定执行城市IDcItyId城市标识号IntM按照GB/T2260中的规定执行区县IDdIstrIctId区县标识号IntM按照GB/T2260中的规定执行安装位置设备的安装位置strIngM地址名称经度longItude设备位置经纬度strIngM经度纬度latItude设备位置经纬度strIngM纬度设备维护单位proporg设备维护单位strIngM单位名称建成时间buIltDate建成时间strIngM字符串格式“yyyy-mm-dd”设备类型FItEquIpmentType设备类型strIngM按照GB19272—2011的规定执行状态state设备当前状态strIngM见表2设备状态编码使用年限寿命yearsofLIfe使用寿命年限strIngo使用寿命年限,单位为年(a)设备厂家IDvendorId设备厂家标识strIngM厂家标识设备型号equIpModel设备型号strIngM设备型号表14设备信息注册输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明10T/CSGF019—20227.2.2设备信息删除接口及参数接口名称:DeletesecGenBasIcData。输入参数见表15,输出参数见表16。表15设备信息删除输入参数中文名称参数名称说明数据类型约束/条件值域设备IDfacIlItIesId设备的识号strIngM字符串表16设备信息删除输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明7.2.3设备信息获取接口及参数接口名称:GetsecGenBasIcData。输入参数见表17,输出参数见表18。表17设备信息获取输入参数中文名称参数名称说明数据类型约束/条件值域设备IDfacIlItIesId设备的识号strIngM字符串表18设备信息获取输出参数中文名称参数名称说明数据类型约束/条件值域设备名称FItEquIpment设备的名字strIngM设备IDFItEquIpmentId设备的识号strIngM字符串省份IDprovInceId省份标识号IntM按照GB/T2260中的规定执行城市IDcItyId城市标识号IntM按照GB/T2260中的规定执行区县IDdIstrIctId区县标识号IntM按照GB/T2260中的规定执行安装位置设备的安装位置strIngM地址名称11T/CSGF019—2022表18设备信息获取输出参数(续)中文名称参数名称说明数据类型约束/条件值域经度longItude设备位置经纬度strIngM经度纬度latItude设备位置经纬度strIngM纬度设备维护单位propOrg设备维护单位strIngM单位名称建成时间buIltDate建成时间strIngM字符串格式为“yyyy-mm-dd”设备类型FItEquIpmentType设备类型strIngM按照GB19272—2011的规定执行状态state设备当前状态strIngM见表2设备状态编码使用年限寿命yearsOfLIfe使用寿命年限strIngO使用寿命年限,单位为年(a)设备厂家IDvendorId设备厂家标识strIngO厂家标识设备型号equIpModel设备型号名称strIngO设备型号7.2.4设备信息注册、删除、查询流程设备信息注册、删除、查询流程见图5o图5设备信息注册、删除、查询流程7.2.5二代健身路径设备运动数据(以下简称“设备运动数据”)上报接口及参数接口名称:upload2ndGenFItDatao输入参数见表19和表20,输出参数见表21o12T/CSGF019—2022表19设备运动数据上报输入参数中文名称参数名称说明数据类型约束/条件值域设备IDFItEquIpmentId设备编号strIngM字符串采集时间acqTIme采集的时间DatetImeMyyyy-MM-ddHH:mm:ss设备类型FItEquIpmentType设备类型strIngM符合GB19272—2011统计时间statIcTIme统计时间strIngMyyyy-MM-ddHH:mm运动人次sportcnt人次IntM数字用户IDuserId用户标识号IntM数字运动时长sportTIme运动时长strIngM数字,单位为分(mIn)运动数据详情sportDataDetaIl根据设备类型上报详细的运动数据strIngO根据表20数据详情内容表20数据详情内容产品类别数据类别单位准确度二代健身路径设备活动类转动类时间s±1%速度km/h当大于2km/h时,±10%当小于或等于2km/h时,±0.2km/h距离m±10%热量kcal—次数次±1其他(自定义) 摇摆类时间s±1%频率次/mIn±10%次数次±1热量kcal 其他(自定义) 负重类时间s±1%次数次±1热量kcal—其他(自定义)—固定类时间s±1%次数次±1热量kcal 其他(自定义) 13T/CSGF019—2022表21设备运动数据上报输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明7.2.6设备运动数据上报说明适用于可直接连接管理子平台的设备。二代健身路径设备产生的运动数据通过设备运动数据接口上报子平台,上报周期为实时上报单次运动数据,或按5mIn周期上报运动数据报表。运动数据包括:有使用者ID的数据,及匿名使用的数据。7.2.7健身路径设备运动数据上报流程流程图见图6。图6设备运动数据上报方式一流程7.3用户基本信息和运动数据接口及参数7.3.1用户基本信息注册接口及参数接口名称:RegIsteruserData。输入参数见表22,输出参数见表23。14T/CSGF019—2022表22用户基本信息注册输入参数中文名称参数名称说明数据类型约束/条件值域用户IDuserId用户标识号IntM数字用户姓名userName用户名字strIngM用户唯一标识userunIqIdent用户标识号strIngO 用户手机号userMobIleNum用户手机号LongM遵从境内运营商手机号段格式11位用户身份证号userIdNum用户身份证号strIngO遵从身份证号码格式证件类型userIdType用证件类型IntO见表6证件类型编码证件号userIdNum用户证件号strIngO按照相应证件类型格式用户性别用户性别IntM见表4性别编码用户年龄Age用户年龄IntO单位为岁年龄范围编码AgeRang年龄范围IntM见表5年龄范围编码用户体重userweIght用户体重strIngM字符串格式为“www.w”,单位为千克(kg)用户身高userHeIght用户身高strIngM字符串格式为“h.hh”,单位为米(m)表23用户基本信息注册输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明7.3.2用户基本信息删除接口及参数接口名称:DeleteuserData。输入参数见表24,输出参数见表25。表24用户基本信息删除输入参数中文名称参数名称说明数据类型约束/条件值域用户IDuserId用户标识号IntM数字15T/CSGF019—2022表25用户基本信息删除输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明7.3.3用户个人基本信息查询接口及参数接口名称:FInduserData。输入参数见表26,输出参数见表27。表26用户个人基本信息查询输入参数中文名称参数名称说明数据类型约束/条件值域用户IDuserId用户标识号IntM数字用户姓名userName用户名字strIngM用户手机号userMobIleNum用户手机号LongM遵从境内运营商手机号段格式11位用户性别用户性别IntM见表4性别编码表27用户个人基本信息查询输出参数中文名称参数名称说明数据类型约束/条件值域用户IDuserId用户标识号IntM数字用户姓名userName用户名字strIngO用户唯一标识userunIqIdent用户标识号strIngO 用户手机号userMobIleNum用户手机号LongO遵从境内运营商手机号段格式11位用户身份证号userIdNum用户身份证号strIngO遵从身份证号码格式证件类型userIdType用证件类型IntO见表6证件类型编码证件号userIdNum用户证件号strIngO按照相应证件类型格式用户性别用户性别IntM见表4性别编码用户年龄Age用户年龄IntO单位为岁年龄范围编码AgeRang年龄范围IntM见表5年龄范围编码16T/CSGF019—2022表27用户个人基本信息查询输出参数(续)中文名称参数名称说明数据类型约束/条件值域用户体重userweIght用户体重strIngM字符串格式“www.w”,单位为千克(kg)用户身高userHeIght用户身高strIngM字符串格式“h.hh”,单位为米(m)7.3.4用户基本信息注册、删除、查询获取流程用户基本信息注册、删除、查询获取流程见图7。图7用户基本信息注册、删除、查询获取流程7.3.5用户运动数据上报接口及参数接口名称:uploadusersportData。输入参数见表28和表20,输出参数见表29。表28用户运动数据上报输入参数中文名称参数名称说明数据类型约束/条件值域备注设备IDFItEquIpId设备编号strIngM字符串 设备名称FItEquIpname设备名称strIngM 17T/CSGF019—2022表28用户运动数据上报输入参数(续)中文名称参数名称说明数据类型约束/条件值域备注采集时间采集的时间DatetImeMyyyy-MM-ddHH:mm:ss 统计时间statICTIme统计时间strIngMyyyy-MM-ddHH:mm—用户IDuserId用户标识号IntM数字 用户姓名userName用户名字strIngM 运动项目sportItem运动项目strIngM 运动时长sportTIme使用设备运动时长strIngM(mIn) 运动次数sportcnt统计时间内s使用设备运动次数IntM数字 运动消耗热量BurncaloorIe燃烧卡路里(大卡)IntO数字 运动距离sportDIst运动距离IntO数字,单位为米(m)转动类设备平均速度sportspeed运动速度IntO数字,单位为千米每小时(km/h)转动类或摇摆类心率sportHeartrate运动心率IntO数字,单位为次每分(次/mIn) 运动数据详情sportDataDetaIl根据设备类的运动数据strIngO字符串根据表20上报详情表29用户运动数据上报输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明7.3.6用户运动数据上报流程用户运动数据上报流程图见图8。18T/CSGF019—2022图8用户运动数据上报流程7.4二代健身路径健身指导(以下简称“健身指导”)接口及参数7.4.1健身指导上传接口及参数接口名称:uploadsecGenFItGUIdance。输入参数见表30。输出参数见表31。表30健身指导上传输入参数中文名称参数名称说明数据类型约束/条件值域设备名称FItEqUIpname设备名称strIngM运动项目sportItem运动项目strIngM提供者sUpplIer单位名称strIngM字符串提供者IDsUpplIerID单位标识号strIngM健身指导健身指导文字strIngM建议运动时长sportTIme备运动时长strIngO数字,单位为分(mIn)建议运动次数sportcnt备运动次数IntO数字指导视频FItGUIdancevIdeoIP健身指导视频网络地址strIngO网络视频表31健身指导上传输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复19T/CSGF019—2022表31健身指导上传输出参数(续)中文名称参数名称说明数据类型约束/条件值域状态说明errMsg状态说明strIngM具体说明健身指导IDFItGUIdanceID健身指导编号strIngM字符串。号,失败返回空7.4.2健身指导上传流程健身指导上传流程见图9。图9健身指导上传流程7.4.3健身指导查询接口及参数接口名称:GetsecGenusIngGUIdance。输入参数见表32。输出参数见表33。表32健身指导查询输入参数中文名称参数名称说明数据类型约束/条件值域设备名称FItEqUIpname设备名称strIngM运动项目sportItem运动项目strIngM表33健身指导查询输出参数中文名称参数名称说明数据类型约束/条件值域设备名称FItEqUIpname设备名称strIngM字符串运动项目sportItem运动项目strIngM提供者sUpplIer单位名称strIngM字符串提供者IDsUpplIerID单位标识号strIngM健身指导健身指导文字strIngM健身指导FItGUIdanceID健身指导编号strIngM字符串20T/CSGF019—2022表33健身指导查询输出参数(续)中文名称参数名称说明数据类型约束/条件值域建议运动时长sportTIme用设备运动时长strIngO数字,单位为分钟(mIn)建议运动次数sportcnt使用设备运动次数IntO数字指导视频FItGuIdancevIdeoIP健身指导视频网络地址strIngO网络视频7.4.4健身指导查询获取流程健身指导查询获取流程见图10。图10健身指导查询获取流程7.5二代健身路径设备厂商信息(以下简称“设备厂商信息”)接口及参数7.5.1设备厂商信息注册接口及参数接口名称:syncEquIpvendorBasIcData。输入参数见表34,输出参数见表35。表34设备厂商信息注册输入参数中文名称参数名称说明数据类型约束/条件值域设备厂家IDvendorId设备厂家标识号IntM唯一标识厂家名称(简称)vendorName厂家名称(简称)strIngM企业全称enterprIseFullName企业全称strIngO企业纳税人识别号enterprIseunINum企业纳税人识别号strIngO字符串办公地址办公地址strIngO地址信息21T/CSGF019—2022表34设备厂商信息注册输入参数(续)中文名称参数名称说明数据类型约束/条件值域官网websIte官网strIngO网址联系人contactName联系人strIngO联系电话contactTel联系电话strIngO字符串邮箱contactEmaIl邮箱strIngO邮件地址传真contactFax传真strIngO字符串表35设备厂商信息注册输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明7.5.2设备厂商信息注册流程设备厂商信息注册流程见图11。图11设备厂商信息注册流程7.6二代健身路径维护方信息(以下简称“维护方信息”)接口及参数7.6.1维护方信息注册接口及参数接口名称:syncEquIpservIcecompData。输入参数见表36,输出参数见表37。表36维护方信息注册输入参数中文名称参数名称说明数据类型约束/条件值域维护方IDvendorId维护方标识号IntM唯一标识维护方名称(简称)vendorName维护方名称(简称)strIngM22T/CSGF019—2022表36维护方信息注册输入参数(续)中文名称参数名称说明数据类型约束/条件值域企业全称enterprIseFullName企业全称strIngO企业纳税人识别号enterprIseunINum企业纳税人识别号strIngO字符串办公地址办公地址strIngO地址信息官网websIte官网strIngO网址联系人contactName联系人strIngO联系电话contactTel联系电话strIngO字符串邮箱contactEmaIl邮箱strIngO邮件地址传真contactFax传真strIngO字符串表37维护方信息注册输出参数中文名称参数名称说明数据类型约束/条件值域状态码errcode状态码IntM0成功—1失败403重复状态说明errMsg状态说明strIngM具体说明7.6.2维护方信息注册流程维护方信息注册流程见图12。图12维护方信息注册流程23T/CSGF019—2022附录A(资料性)数据接入授权和上报A.1说明服务和管理信息的单位向子平台申请数据接入,获得授权后,向指定网络地址上报数据。子平台审核通过后发放获取令牌接口的参数,使用令牌调用相关数据上报接口进行数据上报。A.2子平台参数各管理系统申请接入审核通过后获得分配参数见表A.1。表A.1子平台参数参数名称参数描述appId调用获取令牌接口获取令牌时的参数appKey上报数据传输加密的密钥A.3数据上报上报接口采用HTTPS协议,POST方式提交,字符编码UTF-8。其中HEADER部分传递access-token值通过参数AuthorIzatIon传输,Body部分传递接口业务参数,业务参数以json对象格式拼接。A.4令牌A.4