T_PSC 4-2022 海洋环境安全保障平台数据共享接口规范.pdf

海洋环境安全保障平台数据共享接口规范 Specifications for data sharing interface of marine environment security platform 2022-03-29 发布 2022-03-29 实施 ICS 07.060 CCS A45；A90 团体标准 T/PSC 5-2022 中国太平洋学会 发布 T/PSC 5-2022 I 目次 前言.II 引言.III 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 设计原则.1 语言无关性.1 接口封装性.1 访问透明性.1 接口重用性.1 5 数据共享接口命名.1 接口命名.2 接口参数.2 6 数据共享接口模型设计.3 概述.3 数据信息元模型设计.3 结构化数据元模型设计.4 非结构化数据元模型设计.4 附录 A（资料性）数据共享接口示例.6 参考文献.36 T/PSC 5-2022 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由国家海洋信息中心提出。本文件由中国太平洋学会归口。本文件起草单位：国家海洋信息中心、北京辰安科技股份有限公司。本文件主要起草人：韩璐遥、崔晓健、梁建峰、宋晓、张维、韦广昊、郑兵、李程、孙丽娥、耿姗姗。T/PSC 5-2022 III 引言“海洋环境安全保障平台”是国家重点研发计划“海洋环境安全保障”专项的建设内容，是具有海洋环境安全信息综合集成与融合分析、海洋环境安全预警、风险管理和应急辅助决策等功能的大型综合信息系统，是国家安全平台的重要组成部分。本文件规定了海洋环境安全保障平台数据共享接口的设计规范，可指导海洋环境安全保障相关信息系统的数据共享接口的设计和调用，提升海洋环境安全保障平台的数据共享服务和数据获取能力。T/PSC 5-2022 1 海洋环境安全保障平台数据共享接口规范 1 范围 本文件规定了海洋环境安全保障平台数据共享接口的设计原则，以及接口命名、参数命名和模型设计规范。本文件适用于海洋环境安全保障平台数据的交换、共享和服务。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 21062.3 政务信息资源交换体系 第3部分：数据接口规范 3 术语和定义 下列术语和定义适用于本文件。3.1 海洋环境安全 marine environment security 与海洋经济和人类活动相关的海洋自然环境、资源开发环境和权益保障环境处于良好状态，未遭受不可恢复的破坏或严重威胁。3.2 海洋环境安全保障平台 marine environment security platform 以公共安全科技为核心，以信息技术为支撑，以海洋环境安全管理过程为主线，为常态下的日常安全管理和非常态下的海上环境安全事件应对提供服务的技术保障系统。3.3 数据共享接口 data sharing interface 符合一定标准规范的，可供系统间实现数据传输和交换的通信通道。4 设计原则 语言无关性 接口的设计与实现不依赖于某一特定编程语言，使用的编程语言应能够生成符合接口规范要求的可执行代码。接口封装性 客户端应看不到数据对象的属性信息，访问数据对象的操作应通过接口实现。访问透明性 客户端仅能通过一致的方式使用接口提供的服务。接口重用性 一个接口可以通过重用另一个接口的功能为用户提供服务。5 数据共享接口命名 T/PSC 5-2022 2 接口命名 接口采用英文字母与数字相结合的方式命名，由 3 部分组成。其中，第 1 部分为分类码，采用 2 位大写英文字母，表示数据分类；第 2 部分为场景码，采用不大于 100 位的小写英文字母，表示服务场景；第 3 部分为序号码，采用 2 位阿拉伯数字（00-99），同场景数据按命名先后依次排序。3 部分之间以连接符“_”相连。海洋环境安全保障平台数据共享接口命名方法见图 1。图 1 接口命名方法 示例：海岛地名数据的接口可以命名为“JC_daoming_00。其中：“JC”为分类码，表示此共享接口所对应的数据分类为海洋环境安全基础数据。“daoming”为场景码，表示此共享接口的服务场景是调用海岛地名数据。“00”为序号码。接口参数 参数采用英文字母命名，由 3 部分组成。其中，第 1 部分为分类码，采用 2 位大写英文字母，表示数据分类；第 2 部分为数据类型码，采用不大于 10 位的小写英文字母，表示数据类型；第 3 部分为内容码，采用不大于 100 位的小写英文字母，表示此类参数调用的数据内容。3 部分之间以连接符“_”相连。海洋环境安全保障平台数据共享接口参数命名方法见图 2。图 2 参数命名方法 示例：海岛名称的参数可以命名为“JC_string_mingcheng”。其中：“JC”为分类码，表示此参数调用的数据分类为海洋环境安全基础数据。T/PSC 5-2022 3“string”为数据类型码，表示此参数的数据类型是字符型。“mingcheng”为内容码，表示此参数调用的数据内容为海岛名。6 数据共享接口模型设计 概述 数据接口模型由数据信息元模型、结构化数据元模型和非结构化数据元模型三部分组成。数据共享接口示例见附录 A。数据信息元模型设计 按照 GB/T 21062.3 的规定，结合海洋环境安全保障平台数据的特点，数据信息元模型（见图 3）应包含如下元素：a)信息资源标识（信息资源标识（X XMLML 元素名称：元素名称：IdentifierIdentifier）：）：必选元素，被交换数据内容的唯一标识符；b)信息资源显示名称（信息资源显示名称（X XMLML 元素名称：元素名称：DisplayDisplayN Nameame）：）：必选元素，被交换数据内容的常用名称，如海洋站信息等；c)说明性注释（说明性注释（X XMLML 元素名称：元素名称：ExplanatoryCommentExplanatoryComment）：）：可选元素，对被交换数据内容的解释性描述；d)数据项（数据项（X XMLML 元素名称：元素名称：DataUnitDataUnit）：）：必选元素，构成数据信息的最小数据单位，该元素至少出现一次，可以出现多次，包括：1)数据项标识（XML 元素名称：IDName）：必选元素，数据项的唯一标识符；2)数据项名称（XML 元素名称：Displayname）：必选元素，数据项在业务中的惯用名称，如海洋站分钟数据等；3)数据项定义（XML 元素名称：Definition）：可选元素，对数据项的定义性描述；4)备注（XML 元素名称：Comments）：可选元素，数据项的备注信息；5)数据类型（XML 元素名称：Datatype）：必选元素，数据项值的类型，如字符型、数值型等；6)最大长度（XML 元素名称：MaximumSize）：可选元素，数据项值的最大长度限制；7)最小长度（XML 元素名称：MinimumSize）：可选元素，数据项值的最小长度限制；8)精度（XML 元素名称：Scale）：可选元素，当数据类型为数值型时，小数点后的位数。e)数据项扩展属性（数据项扩展属性（X XMLML 元素名称：元素名称：ExtenAttributeExtenAttribute）：）：可选元素，描述数据项的扩展信息，由扩展属性名称和扩展属性值两个元素组成。T/PSC 5-2022 4 图 3 数据信息元模型 结构化数据元模型设计 结构化数据元模型（见图 4）应包含如下元素：a)数据记录（数据记录（X XMLML 元素名称：元素名称：RecordDataRecordData）：）：必选元素，组成结构化数据的最小单位，表示一条记录。数据记录由一个或多个数据项组成；b)数据项（数据项（X XMLML 元素名称：元素名称：UnitDataUnitData）：必选元素，组成数据记录的最小单位，包括：1)数据项标识（XML 元素名称：UnitIDName）：必选元素，数据项的唯一标识符；2)数据项名称（XML 元素名称：UnitDisplayName）：必选元素，数据项在业务中的惯用名称，如航次号、站次号等；3)数据项值（XML 元素名称：UnitValue）：可选元素，数据项的值。图 4 结构化数据元模型 非结构化数据元模型设计 非结构化数据元模型（见图 5）应包含如下元素：a)对象标识（对象标识（X XMLML 元素名称：元素名称：IDNameIDName）：）：必选元素，非结构化数据的唯一标识；b)对象显示名称（对象显示名称（X XMLML 元素名称：元素名称：DisplayNameDisplayName）：）：必选元素，非结构化数据的常用名称，如温盐背景场图件等；T/PSC 5-2022 5 c)描述（描述（X XMLML 元素名称：元素名称：DescriptionDescription）：）：可选元素，对非结构化数据的解释性信息；d)类型（类型（X XMLML 元素名称：元素名称：TypeDescriptionTypeDescription）：）：可选元素，描述非结构化数据的类型，如文本数据、多媒体数据等；e)对象内容（对象内容（X XMLML 元素名称：元素名称：ContentContent）：）：必选元素，非结构化数据的内容，包括文件名称、URL、文件内容等。图 5 非结构化数据元模型T/PSC 5-2022 6 A A 附录A （资料性）数据共享接口示例 下面给出了溢油突发事件应急监测数据、风暴潮预报产品数据和生态灾害应急监测数据共享接口示例，见示例1示例3。示例1：溢油突发事件应急监测数据共享接口 yiyoutufashijian 溢油突发事件应急监测数据 溢油突发事件安全保障所需数据 0001 标识码 ID 唯一主键 字符型 20 0002 灾害名称 DisasterName 字符型 50 0003 灾害类型 DisasterStyle 字符型 20 0004 灾害等级 DisasterLevel 字符型 20 0005 T/PSC 5-2022 7 经度 Longitude 浮点型 10 0006 纬度 Latitude 浮点型 9 0007 监测时间 Time 时间型 14 0008 监测手段 MonitorMode 字符型 50 0009 监测单位 MonitorDept 字符型 100 0010 监测人员 MonitorPerson 字符型 20 0011 类型 Type 字符型 20 T/PSC 5-2022 8 0012 溢油地点距离 LocDistance 字符型 20 0013 溢油原因 Cause 字符型 20 0014 覆盖面积 CoverArea 浮点型 5 0015 分布面积 DistriArea 浮点型 5 0016 覆盖率 CoverRate 浮点型 5 0017 油品特性 PetrolCharacter 浮点型 20 0018 油膜厚度 Thickness 浮点型 T/PSC 5-2022 9 5 0019 溢油密度 Density 浮点型 5 0020 粘稠度 Viscosity 浮点型 5 0021 分离特性 Sepatation 字符型 20 0022 溢油指纹 Fingerprint 字符型 20 0023 毒理特性 PoisonCharacter 字符型 20 0024 流速 FlowSpeed 浮点型 5 0025 流向 T/PSC 5-2022 10 FlowDirection 浮点型 5 0026 风速 WindSpeed 浮点型 5 0027 风向 WindDirection 整型 3 0028 溶解氧 DO 浮点型 5 0029 化学需氧量 COD 浮点型 5