海洋环境安全保障平台数据共享接口规范(T-PSC 4—2022).pdf

《海洋环境安全保障平台数据共享接口规范(T-PSC 4—2022).pdf》由会员分享，可在线阅读，更多相关《海洋环境安全保障平台数据共享接口规范(T-PSC 4—2022).pdf（40页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、 海洋环境安全保障平台数据共享接口规范 Specifications for data sharing interface of marine environment security platform 2022-03-29 发布 2022-03-29 实施 ICS 07.060 CCS A 45;A 90 团体标准 T/PSC 4-2022 中国太平洋学会 发布 T/PSC 4-2022 I 目次 前言.II 引言.III 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 设计原则.1 语言无关性.1 4.1 接口封装性.1 4.2 访问透明性.1 4.3 接口重用性.1 4.4

2、 5 数据共享接口命名.1 接口命名.2 5.1 接口参数.2 5.2 6 数据共享接口模型设计.3 概述.3 6.1 数据信息元模型设计.3 6.2 结构化数据元模型设计.4 6.3 非结构化数据元模型设计.4 6.4 附录 A（资料性）数据共享接口示例.6 参考文献.36 T/PSC 4-2022 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由国家海洋信息中心提出。本文件由中国太平洋学会归口。本文件起草单位：国家海洋信息中心、北京辰安科技股份有限

3、公司。本文件主要起草人：韩璐遥、崔晓健、梁建峰、宋晓、张维、韦广昊、郑兵、李程、孙丽娥、耿姗姗。T/PSC 4-2022 III 引言“海洋环境安全保障平台”是国家重点研发计划“海洋环境安全保障”专项的建设内容，是具有海洋环境安全信息综合集成与融合分析、海洋环境安全预警、风险管理和应急辅助决策等功能的大型综合信息系统，是国家安全平台的重要组成部分。本文件规定了海洋环境安全保障平台数据共享接口的设计规范，可指导海洋环境安全保障相关信息系统的数据共享接口的设计和调用，提升海洋环境安全保障平台的数据共享服务和数据获取能力。T/PSC 4-2022 1 海洋环境安全保障平台数据共享接口规范 1 范围

4、本文件规定了海洋环境安全保障平台数据共享接口的设计原则，以及接口命名、参数命名和模型设计规范。本文件适用于海洋环境安全保障平台数据的交换、共享和服务。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 21062.3 政务信息资源交换体系 第3部分：数据接口规范 3 术语和定义 下列术语和定义适用于本文件。3.1 海洋环境安全 marine environment security 与海洋经济和人类活动相关的海洋自然环境、资源开发环境

5、和权益保障环境处于良好状态，未遭受不可恢复的破坏或严重威胁。3.2 海洋环境安全保障平台 marine environment security platform 以公共安全科技为核心，以信息技术为支撑，以海洋环境安全管理过程为主线，为常态下的日常安全管理和非常态下的海上环境安全事件应对提供服务的技术保障系统。3.3 数据共享接口 data sharing interface 符合一定标准规范的，可供系统间实现数据传输和交换的通信通道。4 设计原则 语言无关性 4.1 接口的设计与实现不依赖于某一特定编程语言，使用的编程语言应能够生成符合接口规范要求的可执行代码。接口封装性 4.2 客户端应看

6、不到数据对象的属性信息，访问数据对象的操作应通过接口实现。访问透明性 4.3 客户端仅能通过一致的方式使用接口提供的服务。接口重用性 4.4 一个接口可以通过重用另一个接口的功能为用户提供服务。5 数据共享接口命名 T/PSC 4-2022 2 接口命名 5.1 接口采用英文字母与数字相结合的方式命名，由 3 部分组成。其中，第 1 部分为分类码，采用 2位大写英文字母，表示数据分类；第 2 部分为场景码，采用不大于 100 位的小写英文字母，表示服务场景；第 3 部分为序号码，采用 2 位阿拉伯数字（00-99），同场景数据按命名先后依次排序。3 部分之间以连接符“_”相连。海洋环境安全保障

7、平台数据共享接口命名方法见图 1。图 1 接口命名方法 示例：海岛地名数据的接口可以命名为“JC_daoming_00。其中：“JC”为分类码，表示此共享接口所对应的数据分类为海洋环境安全基础数据。“daoming”为场景码，表示此共享接口的服务场景是调用海岛地名数据。“00”为序号码。接口参数 5.2 参数采用英文字母命名，由 3 部分组成。其中，第 1 部分为分类码，采用 2 位大写英文字母，表示数据分类；第 2 部分为数据类型码，采用不大于 10 位的小写英文字母，表示数据类型；第 3 部分为内容码，采用不大于 100 位的小写英文字母，表示此类参数调用的数据内容。3 部分之间以连接符“

8、_”相连。海洋环境安全保障平台数据共享接口参数命名方法见图 2。图 2 参数命名方法 示例：海岛名称的参数可以命名为“JC_string_mingcheng”。其中：“JC”为分类码，表示此参数调用的数据分类为海洋环境安全基础数据。T/PSC 4-2022 3“string”为数据类型码，表示此参数的数据类型是字符型。“mingcheng”为内容码，表示此参数调用的数据内容为海岛名。6 数据共享接口模型设计 概述 6.1 数据接口模型由数据信息元模型、结构化数据元模型和非结构化数据元模型三部分组成。数据共享接口示例见附录 A。数据信息元模型设计 6.2 按照 GB/T 21062.3 的规定，

9、结合海洋环境安全保障平台数据的特点，数据信息元模型（见图 3）应包含如下元素：a)信息资源标识（信息资源标识（X XMLML 元素名称：元素名称：IdentifierIdentifier）：）：必选元素，被交换数据内容的唯一标识符；b)信息资源显示名称（信息资源显示名称（X XMLML 元素名称：元素名称：DisplayDisplayN Nameame）：）：必选元素，被交换数据内容的常用名称，如海洋站信息等；c)说明性注释（说明性注释（X XMLML 元素名称：元素名称：ExplanatoryCommentExplanatoryComment）：）：可选元素，对被交换数据内容的解释性描述；d

10、)数据项（数据项（X XMLML 元素名称：元素名称：D DataUnitataUnit）：）：必选元素，构成数据信息的最小数据单位，该元素至少出现一次，可以出现多次，包括：1)数据项标识（XML 元素名称：IDName）：必选元素，数据项的唯一标识符；2)数据项名称（XML 元素名称：Displayname）：必选元素，数据项在业务中的惯用名称，如海洋站分钟数据等；3)数据项定义（XML 元素名称：Definition）：可选元素，对数据项的定义性描述；4)备注（XML 元素名称：Comments）：可选元素，数据项的备注信息；5)数据类型（XML 元素名称：Datatype）：必选元素，数

11、据项值的类型，如字符型、数值型等；6)最大长度（XML 元素名称：MaximumSize）：可选元素，数据项值的最大长度限制；7)最小长度（XML 元素名称：MinimumSize）：可选元素，数据项值的最小长度限制；8)精度（XML 元素名称：Scale）：可选元素，当数据类型为数值型时，小数点后的位数。e)数据项扩展属性（数据项扩展属性（X XMLML 元素名称：元素名称：ExtenAttributeExtenAttribute）：）：可选元素，描述数据项的扩展信息，由扩展属性名称和扩展属性值两个元素组成。T/PSC 4-2022 4 图 3 数据信息元模型 结构化数据元模型设计 6.3

12、结构化数据元模型（见图 4）应包含如下元素：a)数据记录（数据记录（X XMLML 元素名称：元素名称：RecordDataRecordData）：）：必选元素，组成结构化数据的最小单位，表示一条记录。数据记录由一个或多个数据项组成；b)数据项（数据项（X XMLML 元素名称：元素名称：UnitDataUnitData）：必选元素，组成数据记录的最小单位，包括：1)数据项标识（XML 元素名称：UnitIDName）：必选元素，数据项的唯一标识符；2)数据项名称（XML 元素名称：UnitDisplayName）：必选元素，数据项在业务中的惯用名称，如航次号、站次号等；3)数据项值（XML

13、元素名称：UnitValue）：可选元素，数据项的值。图 4 结构化数据元模型 非结构化数据元模型设计 6.4 非结构化数据元模型（见图 5）应包含如下元素：a)对象标识（对象标识（X XMLML 元素名称：元素名称：IDNameIDName）：）：必选元素，非结构化数据的唯一标识；b)对象显示名称（对象显示名称（X XMLML 元素名称：元素名称：DisplayNameDisplayName）：）：必选元素，非结构化数据的常用名称，如温盐背景场图件等；T/PSC 4-2022 5 c)描述（描述（X XMLML 元素名称：元素名称：DescriptionDescription）：）：可选元素

14、，对非结构化数据的解释性信息；d)类型（类型（X XMLML 元素名称：元素名称：TypeDescriptionTypeDescription）：）：可选元素，描述非结构化数据的类型，如文本数据、多媒体数据等；e)对象内容（对象内容（X XMLML 元素名称：元素名称：C Contentontent）：）：必选元素，非结构化数据的内容，包括文件名称、URL、文件内容等。图 5 非结构化数据元模型T/PSC 4-2022 6 A A 附录A （资料性）数据共享接口示例 下面给出了溢油突发事件应急监测数据、风暴潮预报产品数据和生态灾害应急监测数据共享接口示例，见示例1示例3。示例1：溢油突发事件应

15、急监测数据共享接口 yiyoutufashijian 溢油突发事件应急监测数据 溢油突发事件安全保障所需数据 0001 标识码 ID 唯一主键 字符型 20 0002 灾害名称 DisasterName 字符型 50 0003 灾害类型 DisasterStyle 字符型 20 0004 灾害等级 DisasterLevel 字符型 20 T/PSC 4-2022 7 0005 经度 Longitude 浮点型 10 0006 纬度 Latitude 浮点型 9 0007 监测时间 Time 时间型 14 0008 监测手段 MonitorMode 字符型 50 0009 监测单位 Monit

16、orDept 字符型 100 0010 监测人员 MonitorPerson 字符型 20 0011 类型 Type 字符型 20 T/PSC 4-2022 8 0012 溢油地点距离 LocDistance 字符型 20 0013 溢油原因 Cause 字符型 20 0014 覆盖面积 CoverArea 浮点型 5 0015 分布面积 DistriArea 浮点型 5 0016 覆盖率 CoverRate 浮点型 5 0017 油品特性 PetrolCharacter 浮点型 20 0018 油膜厚度 Thickness T/PSC 4-2022 9 浮点型 5 0019 溢油密度 Den

17、sity 浮点型 5 0020 粘稠度 Viscosity 浮点型 5 0021 分离特性 Sepatation 字符型 20 0022 溢油指纹 Fingerprint 字符型 20 0023 毒理特性 PoisonCharacter 字符型 20 0024 流速 FlowSpeed 浮点型 5 0025 T/PSC 4-2022 10 流向 FlowDirection 浮点型 5 0026 风速 WindSpeed 浮点型 5 0027 风向 WindDirection 整型 3 0028 溶解氧 DO 浮点型 5 0029 化学需氧量 COD 浮点型 5 0030 硫化物 Sulfide

18、 浮点型 8 0031 石油类 Petro 字符型 20 T/PSC 4-2022 11 0032 叶绿素a Phyll-a 字符型 8 0033 现场环境描述 Distance 字符型 500 0034 备注 Remark 字符型 500 标识码 标识码 YY0000001 灾害名称 灾害名称 渤海湾发生溢油事件 灾害类型 灾害类型 溢油 灾害等级 灾害等级 2级 经度 经度 T/PSC 4-2022 12 118.235864 纬度 纬度 39.092738 监测时间 监测时间 2020-12-20 监测手段 监测手段 人工监测 监测单位 监测单位 天津渤海监视监测基地 监测人员 监测人员

19、 王一帆 类型 类型 观测发现 溢油地点距离 溢油地点距离 近岸20公里 溢油原因 溢油原因 海上钻井平台故障 覆盖面积 覆盖面积 125.3 T/PSC 4-2022 13 分布面积 分布面积 205.25 覆盖率 覆盖率 0.61 油品特性 油品特性 高度粘稠 油膜厚度 油膜厚度 0.25 溢油密度 溢油密度 1.21 粘稠度 粘稠度 2.82 分离特性 分离特性 不溶于水 溢油指纹 溢油指纹 油品色谱图 毒理特性 毒理特性 常见 流速 T/PSC 4-2022 14 流速 1.48 流向 流向 1 风速 风速 12.46 风向 风向 2 溶解氧 溶解氧 3.4 化学需氧量 化学需氧量 2

20、.7 硫化物 硫化物 硫化氢、二苯硫茂 石油类 石油类 原油 叶绿素a 叶绿素a 10 现场环境描述 现场环境描述 情况较好，利于处置 T/PSC 4-2022 15 备注 备注 无 T/PSC 4-2022 16 示例2：风暴潮预报产品数据 fengbaochaoyubaochanpin 风暴潮预报产品 风暴潮灾害预报产出 0001 标识码 ID 唯一主键 字符型 20 0002 预报产品名称 ForecastName 字符型 50 0003 预报海区 SeaArea 字符型 50 0004 预警报等级 Level 字符型 20 0005 测站 Station 字符型 20 T/PSC 4-

21、2022 17 0006 风暴潮水位 StormTideLevel 浮点型 5 0007 天文潮水位 AstrTideLevel 浮点型 5 0008 总潮位 TotalLevel 浮点型 5 0009 预报描述 Describe 字符型 5000 0010 预报单位 ForecastDept 字符型 100 0011 预报时间 ForecastTime 日期型 14 0012 预报时效 PredictionAging 字符型 20 T/PSC 4-2022 18 0013 发布时间 ReleaseTime 日期型 14 0014 所属省 Province 字符型 12 0015 所属市 Ci

22、ty 字符型 12 0016 所属县 County 字符型 12 0017 值班人员 DutyPerson 字符型 20 0018 值班电话 DutyTel 字符型 50 0019 备注 Remark T/PSC 4-2022 19 字符型 500 标识码 标识码 FBC0000001 预报产品名称 预报产品名称 风暴潮预报产品 预报海区 预报海区 南海海区 预警报等级 预警报等级 2级 测站 测站 湛江站 风暴潮水位 风暴潮水位 2.8 天文潮水位 天文潮水位 1.2 总潮位 总潮位 4 T/PSC 4-2022 20 预报描述 预报描述 预报结果来自海洋环境安全保障平台。预报单位 预报单位

23、 南海规划与环境研究院 预报时间 预报时间 2021-07-06 预报时效 预报时效 7天 发布时间 发布时间 2021-07-06 所属省 所属省 广东 所属市 所属市 湛江 所属县 所属县 雷州 值班人员 值班人员 张波 值班电话 值班电话 T/PSC 4-2022 21 13822667849 备注 备注 无。T/PSC 4-2022 22 示例3：生态灾害应急监测数据 shengtaizaihai 生态灾害应急监测 生态灾害应急监测 0001 标识码 ID 唯一主键 字符型 20 0002 灾害名称 DisasterName 字符型 50 0003 灾害类型 DisasterStyle

24、 字符型 20 0004 灾害等级 DisasterLevel 字符型 20 0005 经度 Longitude 浮点型 10 0006 T/PSC 4-2022 23 纬度 Latitude 浮点型 9 0007 监测时间 Time 时间型 14 0008 监测手段 MonitorMode 字符型 50 0009 监测单位 MonitorDept 字符型 100 0010 监测人员 MonitorPerson 字符型 20 0011 覆盖面积 CoverArea 浮点型 5 0012 分布面积 DistriArea 浮点型 5 T/PSC 4-2022 24 0013 覆盖率 CoverRa

25、te 浮点型 5 0014 厚度 Thickness 浮点型 5 0015 海藻毒素 SeaweedPoison 字符型 20 0016 毒理特性 Character 字符型 20 0017 风速 WindSpeed 浮点型 5 0018 风向 WindDirection 整型 3 0019 水温 Temp 浮点型 T/PSC 4-2022 25 8 0020 盐度 Salinity 浮点型 8 0021 水色 Water 字符型 2 0022 透明度 Transparency 浮点型 4 0023 水深 Draft 浮点型 6 0024 天气现象 WeatherPattern 字符型 2 0

26、025 海况 SeaState 字符型 2 0026 流速 T/PSC 4-2022 26 FlowSpeed 浮点型 5 0027 流向 FlowDirection 浮点型 5 0028 溶解氧 DO 浮点型 5 0029 PH PH 浮点型 3 0030 活性磷酸盐 PO4P 浮点型 6 0031 亚硝酸盐-氮 NO2N 浮点型 8 0032 硝酸盐-氮 NO3N 浮点型 8 T/PSC 4-2022 27 0033 氨氮 NH4N 浮点型 6 0034 硅酸盐 NO3 浮点型 8 0035 石油类 Oil 浮点型 8 0036 铜 Cu 浮点型 8 0037 铅 Pb 浮点型 8 003

27、8 锌 Zn 浮点型 8 0039 镉 Cd 浮点型 8 T/PSC 4-2022 28 0040 铬 Cr 浮点型 8 0041 总汞 Hg 浮点型 8 0042 砷 Arsenic 浮点型 8 0043 铁 Fe 浮点型 8 0044 化学需氧量 COD 浮点型 5 0045 硫化物 Sulfide 浮点型 8 0046 叶绿素a Phyll-a T/PSC 4-2022 29 浮点型 8 0047 含沙量 Sandiness 浮点型 8 0048 浮游生物种类 Plankton 字符型 20 0049 主要营养元素 Element 字符型 10 0050 现场环境描述 Distance

28、字符型 500 0051 备注 Remark 字符型 500 标识码 标识码 HT0000001 T/PSC 4-2022 30 灾害名称 灾害名称 青岛浒苔灾害 灾害类型 灾害类型 浒苔 灾害等级 灾害等级 3级 经度 经度 121 纬度 纬度 36 监测时间 监测时间 2021-07-25 监测手段 监测手段 人工监测 监测单位 监测单位 北海预报中心 监测人员 监测人员 郑阔 覆盖面积 覆盖面积 T/PSC 4-2022 31 125.3 分布面积 分布面积 205.25 覆盖率 覆盖率 0.61 厚度 厚度 0.3 海藻毒性 海藻毒性 无毒 毒理特性 毒理特性 常见 风速 风速 3.5

29、 风向 风向 1 水温 水温 20.2 盐度 盐度 2.7 T/PSC 4-2022 32 水色 水色 清 透明度 透明度 0.5 水深 水深 1.3 天气现象 天气现象 云 海况 海况 良 流速 流速 1.48 流向 流向 1 溶解氧 溶解氧 3.6 PH PH 7.0 活性磷酸盐 T/PSC 4-2022 33 活性磷酸盐 0.002 亚硝酸盐-氮 亚硝酸盐-氮 0.013 硝酸盐-氮 硝酸盐-氮 0.0003 氨氮 氨氮 0.0102 硅酸盐 硅酸盐 0.0031 石油类 石油类 无 铜 铜 0.0014 铅 铅 0.0009 锌 锌 0.0025 镉 镉 0.0007 T/PSC 4-

30、2022 34 铬 铬 0.0003 总汞 总汞 0.0001 砷 砷 0.0006 铁 铁 0.0104 化学需氧量 化学需氧量 2.9 硫化物 硫化物 0.18 叶绿素a 叶绿素a 8 含沙量 含沙量 0.15 浮游生物种类 浮游生物种类 游泳动物 T/PSC 4-2022 35 主要营养元素 主要营养元素 氮 现场环境描述 现场环境描述 现场异味较大 备注 备注 无 T/PSC 4-2022 36 参考文献 1 GB/T 32419.4-2016 信息技术 SOA技术实现规范 第4部分：基于发布/订阅的数据服务接口 2 GB/T 32633-2016 分布式关系数据库服务接口规范 3 GB/T 32908-2016 非结构化数据访问接口规范 4 GB/T 36345-2018 信息技术 通用数据导入接口 5 GB/T 38672-2020 信息技术 大数据 接口基本要求 6 GB/T 39443-2020 公共信用信息交换方式及接口规范 7 GA 381.1-2002 公共数据交换格式 第1部分：应用层接口格式 8 GA 381.2-2002 公共数据交换格式 第2部分：交换层接口格式