5.4.2.2接口命名规范

GB/T39584—2020

接口名称应具有与接口功能相对应的含义，应采用描述接口功能的单词表示，单词应采用小写字 母。若接口名称由至少两个单词组成，则除第一个单词以外，其余单词的首字母宜大写。 接口命名见示例。

5.4.2.3参数定义规范

接口参数是可选项，应根据接口功能确定是否需要参数。若存在参数紧固件标准，则参数说明见表5。

表5客户端中间件接口参数说明

5.4.2.4返回值定义规范

接口返回值应为可选项，应根据接口功能确定是否需要返回值。若存在返回值，则应指明返回值类 型、取值及其表示的含义。 返回值规范见示例。 示例：返回值类型为boolean.取值为true或false.表示添加成功或添加失败

提供地图相关资源，并可以对地图进行访问与操作，一般应包括以下功能： a）获取地图列表，包括服务器上地图的名称、URI、资源类型等： b） 获取地图图片； c）获取地图的格网图片； d） 获取某幅地图的图层集合； e）获取某个图层的信息； f）获取地图当前状态的基本信息，包括该地图的中心点、比例尺、地图显示范围、图片大小、地图 单位、距离度量单位等 地图服务接口包括地图集合接口、地图接口、图像接口、图像瓦片接口、图层集合接口和图层接口

6.2.2地图集合接口

资源配置项ID、资源类型等

6.2.2.2接口定义

6.2.2.3接口参数说明

表6地图集合接口请求参数

表6地图集合接口请求

6.2.2.4接口响应结构

表7地图集合接口响应结构

地图接口是对地图进行操作的入口，用于获取该地图当前状态的基本信息，包括中心点、比例尺、地 图显示范围、图片大小、地图单位、距离度量单位、包含的图层、包含的图片等，并可以对该地图进行修改 或删除，创建一个临时图层集，或创建一幅新地图

6.2.3.2接口定义

6.2.3.3接口参数说明

GB/T39584—2020

分为两种情况。第一种，由具体的地图名称（mapName)来标识地图，地图名称可以是中文。第二 种，由具体地图的索引号（mapIndex)来标识地图，从0开始编号，依次为0、1、2、3等，要有标识说明。 优先以mapName匹配。请求参数见表8。

表8地图接口请求参数

6.2.3.4接口响应结构

表9地图接口响应结构

I用于获取地图中的一幅

6.2.4.2接口定义

6.2.4.3接口参数说明

GB/T39584—2020

表10图像接口请求参数

6.2.4.4接口响应结构

响应结构见表11。其中，地图参数见表12，地图颜色模式见表13，校验方式见表14，图片返回 表15。

表11图像接口响应结构

GB/T39584—2020

6.2.5图像瓦片接口

图像瓦片接口用于获取由完整的地图图片以像素为单位按相同大小切割成而成的格网图片

6.2.5.2 接口定义

6.2.5.3接口参数说明

请求参数见表16。 注：参数确定了格网的位置等信息

表16图像瓦片接口请求参数

6.2.5.4接口响应结构

表17图像瓦片接口响应结构

6.2.6图层集合接口

口用于获取地图中的所不

6.2.6.2接口定义

6.2.6.3接口参数说明

6.2.6.4接口响应结构

GB/T39584—2020

6.2.7.2接口定义

6.2.7.3接口参数说明

表20图层接口请求参数

6.2.7.4接口响应结构

表21图层接口响应结构

6.3空间数据服务接口

GB/T39584—2020

提供空间数据资源及属性，并可以对空间数据进行访问与操作，一股应包括以下功能： a）获取服务器提供的所有数据源信息，包括数据源名称、数据源描述、引擎类型、投影信息、坐标 单位、距离单位等； b） 修改数据源信息，如数据源描述、坐标单位、距离单位等； 获取数据源中的数据集信息，包括数据集名称、类型、范围、投影信息等； d） 创建一个新的数据集，包括点、线、面数据集； e） 修改数据集信息，如数据集描述信息、字符集、投影坐标系等； f）删除数据集； g 获取一个数据集中要素信息集合，包括数据集中要素的个数、要素对应的几何对象的类型、各 个要素的URI等信息； h）对要素进行添加、删除、修改操作； 1 获取一个要素的信息，包括属性字段名称列表、属性字段值列表和要素对应的几何对象； 1 修改一个要素，包括属性信息和空间信息； k）删除一个要素； 1 获取字段信息集合； m）添加一个字段，仅支持在空数据集中进行字段添加； n）对数据源中的数据进行查询，获取符合条件的要素集合 注：查询方式包括：ID模式、几何对象的缓冲区模式、缓冲区加属性过滤器模式、空间查询模式、空间查询加属性过 滤器的模式、SQL模式等， 空间数据服务接口包括数据接口、数据源集合接口、数据源接口、数据集集合接口、数据集接口、要 合接口、要素接口、字段集合接口和要素结果集合接口。

6.3.2.2接口定义

6.3.2.3接口参数说明

表22数据接口请求参

6.3.2.4接口响应结构

表23数据接口响应结构

6.3.3数据源集合接口

数据源集合接口用于获取服务器上的所有数据源的信息

6.3.3.,2接口定义

6.3.3.3接口参数

表24数据源集合接口请求参数

6.3.3.4接口响应结构

表25数据源集合接口响应结构

GB/T39584—2020

数据源接口用于获取和修改服务器上的一个具体的数据源信息，也用于获取该数据源所包含的数 据集列表。 数据源接口可获取的数据源信息包括：数据源名称、数据源描述、引擎类型、距离单位、坐标单位、投 彩信息等。 数据源接口可修改的数据源信息包括：数据源描述、坐标单位、距离单位等

6.3.4.2接口定义

6.3.4.3GET方式接口参数说明

取数据源信息，以及数据源所包含的数据集列表

数据源接口GET方式

6.3.4.4GET方式接口响应结构

表27。其中，数据源信息见表28，数据源引擎类型

数据源接口GET方式

表29数据源引擎类型

.4.5PUT方式接口参

PUT方式用于修改数据源信息，请求参数见表30

表30数据源接口PUT方式请求参数

6.3.4.6PUT方式接口响应结构

GB/T39584—2020

表31数据源接口PUT方式响应结构

6.3.5数据集集合接口

数据集集合接口用于创建一个隶属于当前数据源的数据集合，包括点、线、面数据集

6.3.5.2接口定义

稀土标准3.5.3GET方式接口参数说明

方式用于获取数据源中的所有数据集的信息，请

表32数据集集合接口GET方式请求参数

.3.5.4GET方式接口响应结构

表33数据集集合接口GET方式响应结构

6.3.5.5POST方式接口参数说明

POST方式用于创建一个新数据集，包含两种情况。第一种，通过设置数据集名称和数据集类型 建新数据集，请求参数见表34，数据集类型见表35。第二种，通过复制数据集的方式创建新数据 求参数见表36。

数据标准表34数据集集合接口POST方式请求参数（