“随申码”物码编码及应用规范

"随申码"物码编码及应用规范本文件规定了“随申码”物码的编码对象、编码规则、物码版式和物码标识牌、应用方法、安全等要求。本文件适用于：a)权属单位开展“随申码”物码的编码；b)接入单位开展拓展服务接入；c)社会各级单位、组织及个人使用场景服务。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T18284快速响应矩阵码GB/T45396数据安全技术政务数据处理安全要求DB31/T1500—2024“随申码”建设运行技术规范3术语和定义DB31/T1500—2024界定的以及下列术语和定义适用于本文件。3.1物体entity城市管理和社会治理中由政府部门、企事业单位或各级组织管理的物质实体及以数字形式存在的具有明确属性和功能的数字实体。3.2“随申码”物码"suishenma"entitycode基于“随申码”体系中物体（3.1）的唯一二维码。3.3权属单位ownerunit拥有物体的使用权、所有权或管理责任的单位。3.4接入单位integrationunit使用“随申码”物码（3.2）并向企事业单位及个人提供应用场景服务的单位。3.5物码摘要页entitycodebriefingpage用户通过政务服务客户端扫描“随申码”物码后跳转展现的第一个页面。3.6物码拓展服务entitycodeextensionservices接入单位（3.4）根据需求通过“随申码”物码应用向用户提供的物码服务。3.7“随申码”物码服务"suishenma"entitycodeservices“随申码”运行管理平台向权属单位（3.3）提供的物码生码、修改信息、核验、查询、注销等服3.8物码版式entitycodelayout权属单位定义的物码图片和辅助信息的布局、字体、排版等生成的电子文档。3.9物码标识牌entitycodesign按照物码版式（3.8）制作的张贴在物体表面的标牌。4缩略语下列缩略语适用于本文件。API：应用程序编程接口（ApplicationProgrammingInterface）BASE64Url：将十六进制数据转换为可见字符且可以安全使用于URL和文件名的编码规则UUID：通用唯一标识符（UniversallyUniqueIdentifier）5编码对象“随申码”物码编码对象包含以下四类：a)静态物体，如土地、房屋、桥梁、林木等不动产物体；b)准静态物体，如灯杆、井盖、摄像头等一定时间内固定放置的物体；c)动态物体，如飞机、船舶、汽车等可移动的物体；d)虚拟物体，如电子证照、证明文件等电子文件。6编码规则6.1物体唯一编码6.1.1物体唯一编码由物体类型编码（长度4位）、权属单位编码（长度不超过20位）、行业唯一数字编码（长度不超过118位）组成。6.1.2物体类型编码和权属单位编码由“随申码”管理单位负责编码。6.1.3行业唯一数字编码由权属单位编制，编码示例参见附录A。行业唯一数字编码宜包含物体的类型、建设时间、权属单位、业务属性等基础信息要素，其它要素宜包括：a)静态物体和准静态物体的行业唯一编码的生成要素中包含时空标识，符合标准地址库要求的地址信息；b)动态物体的行业唯一编码的生成要素中包含能显著标识物体的外部展示标识；c)虚拟物体的行业唯一编码的生成要素中包含有效期的信息。6.2二维码数据结构6.2.1“随申码”物码码值由域名域、码值长度域、编码后的码值域组成（见图1）。域名域域名域码值长度域基本信息编码值域图1“随申码”物码数据结构6.2.2“随申码”物码数据结构各部分的要求和说明见表1。表1“随申码”物码数据结构表“/”6.2.3“随申码”物码基本信息数据结构见图2，包括：a)签名值域，为使用“随申码”物码服务证书私钥对字段域公共域和保留域进行SM2算法签名后的签名值；b)公共域，由版本号和码唯一标识组成，每个码唯一标识对应一个物体唯一编码，映射关系保存在“随申码”运行管理平台；码版本号码唯一标识签名值域签名值域公共域保留域图2“随申码”物码基本信息数据结构6.2.4“随申码”物码服务基本信息数据结构各部分说明见表2。表2“随申码”物码基本信息数据结构表6.3码制6.3.1“随申码”物码二维码应符合GB/T18284规定的快速响应矩阵码码制。6.3.2二维码符号要求如下：a)数据编码方式为字符模式；b)容错级别为最高级（H级）。7物码版式要求和物码标识牌要求7.1“随申码”物码版式的核心要素为“随申码”物码二维码图片，二维码的中心位置宜放置上海市“一网通办”品牌标志。7.2“随申码”物码权属单位定义的物码通用版式包含物码二维码图片、物体名称、使用提示等，示例参见附录B。权属单位可基于“随申码”物码通用版式，结合本行业要求、物体表面大小等实际情况，制定符合行业需求的物码版式。7.3权属单位应按照物码版式文件制作物码标识牌并在物体表面张贴。物码标识牌材质由物体权属单位自行确定，但应做到可固定安装、清晰可辨、耐污损、耐紫外线、耐潮湿、耐老化等要求，耐用性应不低于三年。8应用方法8.1通用要求8.1.1用户应用“随申码”物码服务的途径有：a)使用政务服务客户端或小程序扫描“随申码”物码，可在跳转后的“随申码”物码摘要页上看到该物体所在区或接入单位的服务入口，快速获得接入单位提供的服务；b)使用接入了“随申码”物码验码服务的终端扫描“随申码”物码，快速获得接入单位提供的服8.1.2接入单位可在“随申码”物码摘要页上拓展服务，为本区、本行业“随申码”物码的扫码用户提供便捷的服务入口。8.1.3“随申码”物码摘要页展示内容宜包含物体摘要信息、拓展服务入口、场景介绍等版块，可根据实际需要增加新的版块。物码摘要页示例参见附录C。8.1.4接入单位应按照统一接入流程和步骤接入“随申码”物码摘要页的拓展服务。接入“随申码”物码摘要页的拓展服务应按照政务服务客户端界面视觉要求进行设计，确保界面风格统一、界面交互体验统一。拓展服务应确保用户认证方式、数据接口等均符合规范。8.1.5接入单位应用的接入、开发、运行应符合DB31/T1500—2024的要求。8.1.6物码应用场景参见附录D。8.2平台功能“随申码”运行管理平台是对“随申码”运行流程、任务、服务等进行管理和监控的系统，应为“随申码”管理单位、物码权属单位、行业主管部门、物码拓展服务接入单位等相关机构提供涵盖物码全生命周期的日常运营管理支撑，并具备以下业务管理功能：a)机构管理：用于物码权属单位、行业主管部门、物码拓展服务接入单位等相关机构信息和权限配置管理；b)用户管理：用于相关用户信息和权限配置管理；c)物码申请管理：用于生码申请、生码审批、下载物码码值、下载物码默认版式文件管理；d)物码激活管理：用于物码激活和坐标信息、实体信息管理；e)物码信息管理：用于物码信息查询、物码信息修改、信息修改审核管理；f)物码核验管理：用于物码核验、核验结果管理；g)物码注销管理：用于物码注销管理；h)拓展服务管理：用于拓展服务注册、服务配置、服务审批、服务接入、服务上架、服务下架、服务删除管理；i)数据管理：用于查看、统计、分析物码、拓展服务场景相关数据。以上a)、b)、c)、d)、e)、f)、g)、h)、i)的业务管理功能的输出方式包括API和页面。8.3物码和拓展服务管理8.3.1物码管理流程物码管理的流程见图3。开始开始生码激活张贴用码注销结束图3物码管理流程生码.1生码途径申请物码途径有以下两种：a)权属单位通过生码接口批量申请物码；b)权属单位通过生码申请页面申请物码。.2获取途径获得物码或物码版式文件途径有以下两种：a)权属单位通过获码接口获得码值，按物码版式要求制作物码版式文件；b)权属单位通过获码页面下载默认物码版式文件。激活张行业主管部门指导物体权属单位按照物码版式文件制作物码标识牌，并按照相关管理规范在物体表面张贴物码标识牌。“随申码”运行管理平台提供以下物码激活接口：a)对于静态实体、准静态实体、动态实体，物体权属单位的用户使用物码应用实际采集物体坐标或填写实体信息后激活其物码；b)虚拟物体可根据业务需要，配置并自动激活物码。用码.1查询“随申码”运行管理平台提供查询信息接口、查询信息页面，查询物码关联信息途径有以下两种：a)权属单位通过查询信息接口查询物码关联信息；b)权属单位通过查询信息页面查询物码关联信息。.2变更“随申码”运行管理平台提供变更信息接口、变更信息页面，变更物码关联信息途径有以下两种：a)权属单位通过变更信息接口，变更物码关联信息；b)权属单位通过变更信息页面，变更物码关联信息。.3验码“随申码”运行管理平台提供验码接口，接入单位通过对接验码接口开展应用的开发。注销“随申码”运行管理平台提供注销接口、注销页面，权属单位通过注销接口或注销页面注销物码。8.3.2拓展服务流程拓展服务涉及的流程见图4。开始开始拓展服务注册拓展服务联调拓展服务上架拓展服务下架拓展服务删除结束图4物码拓展服务流程拓展服务注册接入单位登录“随申码”运行管理平台注册拓展服务信息及拓展服务所使用到的接口，注册完成后获得该服务唯一标识。拓展服务联调.1物码摘要页模板配置“随申码”运行管理平台提供配置物码摘要页模板的功能。接入单位自行选择使用的物码摘要页模.2用户对接接入“随申码”物码摘要页的拓展服务对接分为有身份服务和无身份服务。其中，有身份服务应统一对接政务服务客户端的统一用户体系，实现用户统一。.3配置检测接入“随申码”物码摘要页的拓展服务应通过“随申码”运行管理平台统一配置，并进行集中检测。.4联调测试接入单位完成对接相关工作后，应向“随申码”管理单位申请联调测试，测试通过后方可申请服务上架。拓展服务上架“随申码”运行管理平台提供拓展服务上架页面。拓展服务上架的途径有以下两种：a)接入单位申请上架新拓展服务或上架之前已下架的拓展服务，“随申码”管理单位审批通过后，服务上架；b)“随申码”运行管理平台根据管理要求上架已下架的拓展服务。拓展服务下架“随申码”运行管理平台提供拓展服务下架页面。拓展服务下架的途径有以下两种：a)接入单位申请下架拓展服务，“随申码”管理单位审批通过后，服务下架；b)“随申码”运行管理平台根据管理要求下架拓展服务。拓展服务删除“随申码”运行管理平台提供拓展服务删除页面。拓展服务删除的途径有以下两种：a)接入单位通过删除页面删除已下架的拓展服务；b)“随申码”运行管理平台根据管理要求删除已下架的拓展服务。9安全要求“随申码”物码服务的开发和运行、数据展示、数据传输和数据存储等应符合GB/T45396、DB31/T1500—2024中6.4的规定。（资料性）行业唯一数字编码示例A.1保险业车型识别编码以国家市场监督管理总局为保险业车型制定的编码规则为例：车型识别代码采用17位数字和字母混合码，由车型代码、类别代码、系别代码和风险代码复合而成，参考GB/T44892。a)车型代码长度12位，包括：1)版本代码（1位），采用1位英文字母表示；2)品牌代码（3位），其中前2位为品牌前两位汉字的首字母，第3位英文字母为计算机随机赋值，从A到Z。不同品牌代码不应重复；3)车系代码（2位），大写英文字母表示。同一品牌车系代码不应重复；4)配置款型代码（2位），采用2位大写英文字母表示，与各车型“配置等级”进行对应；5)顺序码（4位），采用4位数字表示，按照顺序从“0001”到“9999”。b)类别代码（1位），采用1位数字表示，按照GA802—2019中的机动车结构分类要求。c)系别代码（1位），采用1位数字表示。d)风险代码（3位），采用1位大写英文字母和2位数字的组合码表示，按照顺序从“A01”到“Z99”。A.2上海市空间数据资源统一编码以市住房和城乡建设管理委员会为CIM平台数据资源制定的编码规则为例：实体编码（即该行业唯一数字编码）总长度为58位，由以下部分组成：a)实体基本编码长度50位，包括：1)OID区域码（30位），参考GB/T40780；2)实体类型码（8位），参考DB31/T401.1；3)顺序码（12位），流水号，由26个字母和10位数字表示，包括：BIM构件类型码4位，高度码（楼层码）4位（参考码，可自定义），顺序码4位组成。b)实体扩展编码（8位），包括：1)数据类型码（2位），采用2位定长阿拉伯数字表示，为顺序码，用数字01～99表示。01矢量数据、02栅格数据、03DEM数据、04DSM数据、05BIM数据、06三维模型数据、07IOT数据、11文本、21表格、31图片、41视频、51音频、91网页数据、99其2)数据版本码（6位），采用6位定长的阿拉伯数字表示，前4位代表实体数据年，后两位是顺序码。（资料性）“随申码”物码通用版式示例图B.1和图B.2为“随申码”物码通用版式示例。图B.1“随申码”物码通用版式示例1图B.2“随申码”物码通用版式示例2（资料性）“随申码”物码摘要页示例图C.l为“随申码”物码摘要页示例。摘要信息图C.1“随申码”物码摘要页示例（资料