T/GAAI 006-2024 智慧渔场数字孪生系统数据接口规范

ICS35.240.01

CCSK60/69

GAAI

广西人工智能学会团体标准

T/GAAI006—2024

智慧渔场数字孪生系统数据接口规范

DataInterfaceSpecificationforSmartFishingGroundDigitalTwinSystem

2024-06-07发布2024-06-07实施

广西人工智能学会发布

T/GAAI006—2024

目次

前言III

引言IV

1范围1

2规范性引用文件1

3术语和定义1

4缩略语1

5智慧渔场数字孪生系统数据接口概述2

基本数据类型2

接口服务分类编码2

接口调用规范3

接口管理规范3

接口编码规范4

6智慧渔场数字孪生系统数据接口定义4

渲染接口4

模型管理接口5

感控数据接口5

视频数据接口5

全球剖分网格码接口5

空间数据接口5

附录A（资料性）智慧渔场数字孪生系统渲染接口参数6

A.1渲染标绘接口6

A.2渲染模型接口6

A.3渲染动画接口6

A.4空间分析接口7

A.5图层接口7

A.6精细化场景接口8

附录B（资料性）智慧渔场数字孪生系统模型管理接口参数9

B.1模型导入接口请求参数9

B.2模型导入进度请求参数9

B.3模型文件查询请求参数9

B.4模型删除接口请求参数10

附录C（资料性）智慧渔场数字孪生系统实时动态数据服务接口11

C.1实时动态数据查询接口列表11

C.2实时动态数据查询接口参数列表11

附录D（资料性）智慧渔场数字孪生系统历史动态数据查询服务接口12

D.1历史数据查询接口列表12

I

T/GAAI006—2024

D.2历史数据查询接口参数列表12

附录E（资料性）智慧渔场数字孪生系统设备远程操控接口13

E.1设备远程操控接口参数列表13

附录F（资料性）智慧渔场数字孪生系统视频数据接口参数14

F.1设备接入接口参数列表14

F.2通道管理接口参数列表14

F.3视频设备操作接口参数列表15

F.4服务器节点管理接口参数列表15

F.5视频AI分析接口参数列表15

附录G（资料性）全球剖分网格码数据服务接口示例17

G.1全球剖分网格码数据服务接口示例17

附录H（资料性）智慧渔场数字孪生系统空间数据示例及接口19

H.1倾斜摄影、地形数据服务url示例19

H.2WMS基础性操作协议19

H.3WMTS基础性操作协议19

参考文献20

II

T/GAAI006—2024

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。

本文件由广西人工智能学会提出并归口。

本文件起草单位：广西科学院、中科星图空间技术有限公司、南宁师范大学、中国科学院海洋研究

所、UniversitiMalaysiaTerengganu、SamRatulangiUniversity。

本文件主要起草人：许贵林、邬满、谢国钧、陆柳霖、刘小宁、王少军、张立斌、严小敏、文莉莉、

曾飞传、于毓佳、黎倩君、郭靖、黄文龙、邱衡通、吴迪、李宛怡、马丹、林承刚、茹小尚、黄乐、玉

衡星、NajiahBintiMusa、WanNurulNadiahWanRasdi、WindaMercedesMingkid、NadirahMusa、

NurulAqilahIberahim、RasinaAbdulRasid、MohdFazrulHisamAbdAziz、NurulUlfahKarim、

MariamMarip。

III

T/GAAI006—2024

引言

本文件旨在建立智慧渔场数字孪生系统数据接口标准，以指导和支持智慧渔场的数字化转型和管理。

智慧渔场数字孪生技术体系利用先进的数据采集、处理和分析技术，将渔场实际运营情况与数字孪生模

型相对应，实现实时监测、预测和优化渔业养殖过程。通过水下摄像头、便携式在线多参数水质监测设

备同时测量和监测多个水质参数，感知渔场实际环境中关键影响因素的变化，实现大范围水质监测和数

据采集，支撑孪生场景中实时可视化，达到现实与虚拟环境的数据信息“孪生”，数字孪生技术的应用

为渔业管理提供了全新的机会和挑战。通过数字孪生模型，我们可以更准确地了解渔场内部环境、鱼类

生长情况、水质变化等关键指标，并基于这些数据进行决策和优化。这种技术的广泛应用不仅有助于提

高渔业养殖效率和产量，还能够减少资源浪费和环境影响，促进可持续发展。

请所有涉及智慧渔场数字孪生系统严格按照本文件执行，并不断反馈和改进，共同推动智慧渔业向

更高水平迈进。

本文件的内容将根据技术和业务需求进行更新和完善。

IV

T/GAAI006—2024

智慧渔场数字孪生系统数据接口规范

1范围

本文件规定了智慧渔场数字孪生系统中渲染接口、模型管理接口、感控数据接口、视频数据接口、

全球剖分网格码接口、空间数据接口。

本文件适用于智慧渔场数字孪生系统的数据接口。

2规范性引用文件

本文件没有规范性引用文件。

3术语和定义

下列术语和定义适用于本文件。

智慧渔场数字孪生smartfishinggrounddigitaltwin

具有渔场数据与数字实体智能联动能力的基于渔场目标实体的数字化表达。

数字孪生digitaltwin

具有保证物理状态和虚拟状态之间以适当速率和精度同步数据连接的特定目标实体的数字化表达。

数字孪生系统digitaltwinsystem

基于数据驱动来实现目标实体与数字实体间各要素动态迭代的系统。

模型model

由精确几何实体、相关三维几何、三维标注及属性构成的数据集定义的完整的产品定义。

水产养殖aquaculture

利用各种水域以各种方式进行水生经济动植物养殖和种植的生产活动。

4缩略语

GIS:地理信息系统(GeographicInformationSystem)

BIM:建筑信息模型(BuildingInformationModel/Modeling)

API:应用程序接口(ApplicationProgrammingInterface)

SDK:软件开发工具包(SoftwareDevelopmentKit)

TCP:传输控制协议(TransmissionControlProtocol)

HTTP:超文本传输协议(HyperTextTransferProtocol)

HTTPS:超文本传输安全协议(HyperTextTransferProtocoloverSecureSocketLayer)

URL:统一资源定位符(UniformResourceLocation)

IP:网际互连协议(InternetProtocol)

GPU:图形处理器(GraphicsProcessingUnit)

pH:酸碱度(PondusHydrogenii)

1

T/GAAI006—2024

5智慧渔场数字孪生系统数据接口概述

基本数据类型

智慧渔场数字孪生系统数据接口中所使用到的基本数据类型定义见表1。

表1基本数据类型定义说明

类型名类型描述类型长度(字节)

CHAR字符型数据1

UCHAR无符号字符型数据1

INT2带符号整数_类型12

INT4带符号整数_类型24

INT8带符号整数_类型38

UINT2无符号整数_类型12

UINT4无符号整数_类型24

FLOAT单精度浮点数4

STRING字符串声明时指定长度

接口服务分类编码

智慧渔场数字孪生系统数据接口中所使用到的主要接口服务分类编码见表2。

表2接口服务分类编码

类型名分类编码操作类型

标绘接口：/Graphic标绘接口：GET

模型接口：/Model模型接口：GET

动画：/Animation动画：GET

渲染接口

空间分析接口：/SpaceAnalysis空间分析接口：GET

图层接口：/LayerManager图层接口：GET

精细化场景：/Scene精细化场景：GET

模型管理接口模型管理接口：/DataManager模型管理接口：POST

2

T/GAAI006—2024

表2接口服务分类编码（续）

类型名分类编码操作类型

查询渔场实时动态数据：/GetAlDataDescription查询渔场实时动态数据：GET

渔场实时动态数据订阅：/SetDataSubscription渔场实时动态数据订阅：POST

感控数据接口

查询渔场历史数据：/GetHisWamsData查询渔场历史数据：GET

设备远程操控接口：/RemoteOperate设备远程操控接口：POST

设备接入接口：/GetDevice设备接入接口：GET

通道管理接口：/ManageTunnel通道管理接口：POST

视频数据接口视频设备操作接口：/OperateDevice视频设备操作接口：POST

视频流服务器节点管理：/ManageStreamNode视频流服务器节点管理：POST

视频AI分析：/AIAnalyse视频AI分析：GET

位置点：/Point位置点：GET

位置线：/Line位置线：GET

全球剖分网格位置面：/Polygon位置面：GET

码数据分类编位置数据标识：/Geotid位置数据标识：GET

码时间多尺度编码：/Tcoding时间多尺度编码：GET

空间计算：/Acrelation空间计算：GET

网格拓扑计算：/Topo网格拓扑计算：GET

三维倾斜：/Giltphoto三维倾斜：GET

基础空间数据

地表地形及其他：/Tilecache地表地形及其他：GET

接口调用规范

5.3.1调用方式

平台支持HTTP或HTTPS协议的服务接口调用方式,采用“[http]或[https]://[服务器地址]/接口名

称”的方式，请求参数不应以未加密的形式通过URL直接传递，应对参数进行加密或后台传递参数。

5.3.2调用安全

服务接口的调用应采用以下两种种安全技术：

——IP地址验证机制：在服务器端建立授权访问的IP地址列表，当通过接口调用服务资源时，服

务器应验证IP地址的有效性，认证通过后执行调用请求；

——动态密钥机制：用户提出接口调用申请时，服务器根据调用者权限生成令牌，只有持有有效

令牌的用户才能够调用接口资源。

接口管理规范

5.4.1命名规范

为了提高可读性和易用性，接口应该使用清晰、简洁且具有描述性的命名。使用动词来表示操作，

使用名词来表示资源或对象。

5.4.2统一风格

在整个项目中保持一致的接口设计风格，包括参数传递方式、错误处理机制、返回值格式等。这样

可以增加代码的可维护性和可理解性。

5.4.3版本管理

对于长期维护的接口，在进行重大变更时，应该采用版本管理的方式来管理接口的不同版本。这样

可以避免因为接口变更导致现有系统的不兼容性。

3

T/GAAI006—2024

5.4.4参数传递

避免使用过多的参数，可以考虑使用对象或结构体作为参数传递。对于可选参数，定义默认值或使

用合适的标记进行区分。

5.4.5参数验证

对于输入参数，应该进行验证和过滤，以确保数据的有效性和安全性。如对于数值类型的参数，可

检查是否为空、是否符合范围等。

5.4.6错误处理

定义明确的错误码和错误信息，以便客户端能够正确处理异常情况。同时，错误信息也应该尽量提

供详细的错误描述，方便调试和排查问题。对于严重错误，考虑使用异常抛出机制。

5.4.7安全考虑

在接口设计中要考虑安全因素，例如对敏感数据的保护、身份验证和授权机制等。采用合适的加密

算法和认证方式可以提高接口的安全性。

5.4.8文档化

及时编写接口文档，包括接口的描述、参数说明、返回值格式等信息。这样可以方便其他开发人员

理解和使用接口，并减少沟通成本。

5.4.9性能优化

在接口设计中要考虑性能问题，避免不必要的数据传输和计算操作，合理使用缓存机制，以提高接

口的响应速度和吞吐量。

5.4.10定期评估和更新

随着项目的演进和需求的变化，定期评估和更新接口设计