DB4401/T 222.1-2023 智慧广州时空信息云平台第 1 部分：共享服务与接口规范

ICS07.040

CCSA75

4401

广州市地方标准

DB4401/T222.1—2023

智慧广州时空信息云平台

第1：共享服务与接口规范部分

SpatiotemporalinformationcloudplatformofsmartGuangzhou—

Part1:Sharingserviceandinterfacespecification

2023-07-20发布2023-08-20实施

广州市市场监督管理局发布

DB4401/T222.1—2023

目次

前言..................................................................................III

引言..................................................................................IV

1范围................................................................................1

2规范性引用文件......................................................................1

3术语和定义..........................................................................1

4缩略语..............................................................................2

5时空基准............................................................................2

6服务模型............................................................................2

6.1服务分类........................................................................2

6.2URI表述形式.....................................................................3

6.3服务用户........................................................................3

6.4管理维护........................................................................3

6.5服务应用........................................................................3

6.6状态码说明......................................................................3

6.7接口返回内容的表述格式..........................................................3

7通用化服务..........................................................................4

7.1资源目录服务....................................................................4

7.2地图服务........................................................................5

7.3网络地图瓦片服务................................................................7

7.4网络地图服务....................................................................8

7.5网络要素服务...................................................................10

7.6三维模型数据服务...............................................................11

8专业化服务.........................................................................11

8.1地名地址匹配服务...............................................................11

8.2坐标转换服务...................................................................12

附录A（资料性）智慧广州时空信息云平台共享服务与接口调用示例..........................14

A.1资源目录服务接口—GetThemes操作调用示例........................................14

A.2资源目录服务接口—CreateTheme操作调用示例......................................20

A.3资源目录服务接口—DropTheme操作调用示例........................................21

A.4资源目录服务接口—UpdateTheme操作调用示例......................................21

A.5资源目录服务接口—UpdateThemeOrder操作调用示例.................................21

A.6地图服务接口—ExportMap操作调用示例............................................22

A.7地图服务接口—Identify操作调用示例.............................................22

A.8地图服务接口—Find操作调用示例.................................................24

A.9地图服务接口—Query操作调用示例................................................25

A.10网络地图瓦片服务接口—GetCapabilities操作调用示例.............................27

I

DB4401/T222.1—2023

A.11网络地图瓦片服务接口—GetTile操作调用示例.....................................27

A.12网络地图瓦片服务接口—GetFeatureInfo操作调用示例..............................28

A.13网络地图服务接口—GetCapabilities操作调用示例.................................29

A.14网络地图服务接口—GetMap操作调用示例..........................................30

A.15网络地图服务接口—GetFeatureInfo操作调用示例..................................30

A.16网络要素服务接口—GetCapabilities操作调用示例.................................31

A.17网络要素服务接口—DescribeFeatureType操作调用示例.............................32

A.18网络要素服务接口—GetFeature操作调用示例......................................33

A.19地名地址匹配服务接口—ForwardMatch操作调用示例................................35

A.20地名地址匹配服务接口—BackwardMatch操作调用示例...............................39

A.21坐标转换服务接口—CGCS2000toGZ2000调用示例....................................42

II

DB4401/T222.1—2023

前言

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

起草。

本文件是DB4401/T222《智慧广州时空信息云平台》的第1部分。DB4401/T222《智慧广州时空信

息云平台》已经发布了以下部分：

——第1部分：共享服务与接口规范；

——第2部分：平台数据规范。

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

本文件由广州市规划和自然资源局提出并归口。

本文件起草单位：广州市城市规划勘测设计研究院、广州市规划和自然资源自动化中心。

本文件主要起草人：何华贵、高毓琳、张鹏程、王明省、林寅燊、王强、刘洋、张明、陶岚、周勍、

于晶涛、郭亮、龚磊、黎栋梁、陈飞、黄盛、邱扬、陈利燕、晏四方、杜剑光。

III

DB4401/T222.1—2023

引言

智慧广州时空信息云平台是国家首批智慧城市时空信息云平台试点的建设成果，是广州市空间信息

共享交换与协同应用的载体，也是全市可复用可共用信息系统平台之一，为全市提供统一时空基础的空

间资源底座服务。DB4401/T222《智慧广州时空信息云平台》旨在规范全市地理信息资源互联互通和共

享利用，拟由两个部分构成：

——第1部分：共享服务与接口规范，目的在于为时空云平台确立可操作的共享服务与接口；

——第2部分：平台数据规范，目的在于确立适用于时空云平台的数据内容。

IV

DB4401/T222.1—2023

智慧广州时空信息云平台

第1部分：共享服务与接口规范

1范围

本文件规定了智慧广州时空信息云平台（以下简称：时空云平台）共享服务与接口规范，包括时空

基准、服务模型、通用化服务和专业化服务。

本文件适用于时空云平台共享服务与接口的发布和访问，为二次开发提供参考。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T25530-2010地理信息服务

CH/T9015-2012三维地理信息模型数据产品规范

DB44/T2214-2019地理信息公共服务平台服务接口规范

T/CAGIS2-2020空间三维模型数据服务接口

3术语和定义

GB/T25530-2010、CH/T9015-2012、DB44/T2214-2019界定的以及下列术语和定义适用于本文件。

3.1

时空信息云平台spatiotemporalinformationcloudplatform

实现在线时空数据、服务功能及其运行支撑环境的总称。

3.2

服务serviceDB4401

由实体通过接口提供的功能的可区分部分。

[来源：GB/T25530-2010，4.1]

3.3

接口interface

描述实体行为特征的命名操作集合。

[来源：GB/T25530-2010，4.2]

3.4

资源目录服务resourcedirectoryservice

提供数据资源组织方式的服务。

3.5

地图服务mapservice

提供访问地图功能的服务，可以分为瓦片地图服务和动态地图服务。

1

DB4401/T222.1—2023

3.6

瓦片地图服务tiledmapservice

提供通过指定参数获取指定位置的地图瓦片的服务。

[来源：DB44/T2214-2019，2.1，有修改]

3.7

动态地图服务dynamicmapservice

提供通过指定参数动态生成地图图片的服务。

[来源：DB44/T2214-2019，2.2，有修改]

3.8

网络要素服务webfeatureservice

提供通过指定参数返回相应的地理要素信息的服务。

[来源：DB44/T2214-2019，2.3，有修改]

3.9

三维模型数据服务threedimensionalmodeldataservice

提供可视化反映相关地理要素在立体空间中的位置、几何形态、表面纹理及其属性等信息的服务。

[来源：CH/T9015-2012，3.2，有修改]

4缩略语

下列缩略语适用于本文件。

HTML：超文本标记语言（HypertextMarkupLanguage）

HTTPS：安全的超文本传输协议（HypertextTransportProtocolSecure）

JSON：轻量级数据交换格式（JavaScriptObjectNotation）

MIME：多用途因特网邮件扩充协议（MultipurposeInternetMailExtensions）

OGC：开放地理空间联盟（OpenGeospatialConsortium）

URI：统一的资源定位（Uniform/UniversalResourceLocator）

WFS：网络要素服务（WebFeatureService）

WMS：网络地图服务（WebMapService）

WMTS：网络地图瓦片服务（WebMapTileService）

XML：可扩展标记语言（ExtensibleMarkupLanguage）

5时空基准

时空云平台空间数据时空基准应满足以下要求：

a)平面基准采用广州2000坐标系；

b)地图投影采用“高斯-克吕格投影（3度分带）”；

c)高程基准采用广州市高程系统；

d)时间基准采用公元纪元和北京时间。

6服务模型

6.1服务分类

2

DB4401/T222.1—2023

本文件规定的共享服务涵盖通用化服务和专业化服务两类，具体如下：

a)通用化服务：包括资源目录服务、地图服务、网络地图瓦片服务、网络地图服务、网络要素

服务、三维模型数据服务；

b)专业化服务：包括地名地址匹配服务、坐标转换服务。

6.2URI表述形式

本文件规定的共享服务接口，使用HTTPS协议的GET或POST方法对服务进行操作。URI的表述形

式应为相对服务基地址/{MapService/ApiService}/serviceid/token的相对路径。

6.3服务用户

时空云平台的用户为广东省统一身份认证的用户，在政务外网环境内，通过粤政易APP扫码或“账

号+密码+验证码”方式登录，时空云平台对通过登录认证的用户进行二次鉴权。

6.4管理维护

在权限范围内，用户在线使用时空云平台实现对服务进行注册发布、修改删除、申请审核等管理维

护操作。

6.5服务应用

本文件规定的服务应用是在政务外网环境运行的、需要使用地理空间数据(功能)的信息系统，覆盖

市-区-街镇-企业等不同层级的组织机构。

6.6状态码说明

本文件采用的状态码及其含义应符合HTTPS协议规定，涉及的状态码见表1。

表1状态码及其含义

状态码值说明

200表示服务器成功执行了客户端的HTTPS请求

400表示客户端的请求参数不合法或没有表达足够的信息

404表示客户端请求的数据资源不存在，即URI无效

405表示数据资源不支持该操作DB4401

406表示数据资源不支持客户端请求的表述格式

500表示服务器端发生非预期情况，导致请求没有完成

6.7接口返回内容的表述格式

本文件规定的共享服务接口返回内容的表述格式与MIME类型的对应关系见表2。

表2接口返回内容的表述格式与MIME类型的对应关系

表述格式MIME类型

JSONapplication/json

XMLapplication/xml

HTMLtext/html

3

DB4401/T222.1—2023

7通用化服务

7.1资源目录服务

7.1.1服务介绍

时空云平台资源目录服务（ThemeService）是对时空云平台内数据资源以层次结构的形式进行重新

组织，以满足特定的应用场景。资源目录服务只关注于目录的获取和访问，不对目录本身的组织方式作

出任何限定。

7.1.2操作列表

资源目录服务接口包括GetThemes、CreateTheme、DropTheme、UpdateTheme和UpdateThemeOrder

等操作，详见表3。

表3资源目录服务接口操作列表

编号操作说明

1GetThemes获取资源目录

2CreateTheme增加目录节点

3DropTheme删除目录节点

4UpdateTheme修改目录节点信息

5UpdateThemeOrder修改目录节点顺序

7.1.3参数说明

资源目录服务接口操作请求参数说明见表4至表8。

表4GetThemes操作请求参数

参数名称说明

themeId字符型（Char32），表示目录ID

f字符型（Char4），表示请求返回格式数据，取值为json或xml，默认为json

表5CreateTheme操作请求参数

参数名称说明

name字符型（Char32），目录名称

type字符型（Char1），目录类型，取值为1（目录）或2（图层），默认为1

field字符型（Char32），指定字段名，多个字段名用,间隔，仅对图层类型有效

value字符型（Char100），指定字段内容，多个字段内容用,间隔，仅对图层类型有效

f字符型（Char4），表示请求返回格式数据，取值为json/xml/html，默认为json

表6DropTheme操作请求参数

参数名称说明

themeId字符型（Char32），表示目录ID

resultFormat字符型（Char4），表示请求返回格式数据，取值为json/xml/html，默认为json

4

DB4401/T222.1—2023

表7UpdateTheme操作请求参数

参数名称说明

themeId字符型（Char32），表示目录ID

name字符型（Char32），目录名称

type字符型（Char1），目录类型，取值为1（目录）或2（图层），默认为1

field字符型（Char32），指定字段名，多个字段名用,间隔，仅对图层类型有效

value字符型（Char100），指定字段内容，多个字段内容用,间隔，仅对图层类型有效

f字符型（Char4），表示请求返回格式数据，取值为json/xml/html，默认为json

表8UpdateThemeOrder操作请求参数

参数名称说明

themeId字符型（Char32），表示目录ID

targetId字符型（Char32），表示拖动到指定目录后排的目录ID

f字符型（Char4），表示请求返回格式数据，取值为json/xml/html，默认为json

7.1.4调用示例

资源目录服务接口调用示例参见附录A.1至A.5。

7.2地图服务

7.2.1服务介绍

时空云平台地图服务（MapService）是一个综合性的接口，包括了对图层数据的浏览、查询、导出

等多种功能，能适应空间数据应用的大多数场景。

7.2.2操作列表

地图服务接口包括ExportMap、Identify、Find和Query等操作，详见表9。

表9地图服务接口操作列表

编号操作DB4401说明

1ExportMap提供对地图数据的实时渲染成图

2Identify查找指定位置的空间要素

3Find提供对地图数据的条件检索功能

4Query对单个图层的条件查询

7.2.3参数说明

地图服务接口操作请求参数说明见表10至表13。

表10ExportMap操作请求参数

参数名称说明

bbox字符型（Char64），请求的数据空间范围，格式为minx,miny,maxx,maxy

size字符型（Char10），返回图片的大小，格式为width*height，默认值为400*400

dpi整数型（Int），生成图片的设备分辨率（点/英寸），默认值为96

5

DB4401/T222.1—2023

表10ExportMap操作请求参数（续）

参数名称说明

imageSR整数型（Int），生成图片的坐标系id，如果未指定则与地图本身一致

bboxSR整数型（Int），bbox参数的坐标系id，如果未指定，则与地图本身一致

format字符型（Char5），返回图片的格式，默认值为png

layers字符型（Char32），请求的图层

transparent布尔型（Bool），返回图片的背景是否透明

f字符型（Char4），表示请求返回格式数据，取值为json/xml/html，默认为json

表11Identify操作请求参数

参数名称说明

geometry字符型（Char500），Identify操作的空间要素，以json格式表示

geometryType字符型（Char30），geometry参数的类型，默认为点类型（esriGeometryPoint）

sr整数型（Int），空间参考的id

layers字符型（Char32），执行Identify操作的图层，默认为全部图层

tolerance整数型（Int），容差，以像素为单位

mapExtent字符型（Char64），当前显示的地图范围，格式为minx,miny,maxx,maxy

imageDisplay字符型（Char64），当前显示的地图的参数，格式为width,height,dpi

returnGeometry布尔型（Bool），是否返回空间对象，默认值为true

f字符型（Char4），表示请求返回格式数据，取值为json/xml/html，默认为json

表12Find操作请求参数

参数名称说明

searchText字符型（Char32），检索词

contains布尔型（Bool），模糊检索还是精确匹配，默认值为true（精确匹配）

searchFields字符型（Char32），检索字段

sr整数型（Int），空间参考的id

layers字符型（Char32），执行Find操作的图层，默认为全部图层

returnGeometry布尔型（Bool），是否返回空间对象，默认值为true

f字符型（Char4），表示请求返回格式数据，取值为json/xml/html，默认为json

表13Query操作请求参数

参数名称说明

text字符型（Char32），检索词

geometry字符型（Char500），Query操作的空间要素，以json格式表示

geometryType字符型（Char30），geometry参数的类型，默认为点类型（esriGeometryPoint）

inSR整数型（Int），输入参数的空间参考id

spatialRel字符型（Char32），与输入的geometry间的空间关系

where字符型（Char32），检索条件

outfields字符型（Char32），需要返回的字段

returnGeometry布尔型（Bool），是否返回空间对象，默认值为true

6

DB4401/T222.1—2023

表13Query操作请求参数（续）

参数名称说明

f字符型（Char4），表示请求返回格式数据，取值为json/xml/html，默认为json

7.2.4调用示例

地图服务接口调用示例参见附录A.6至A.9。

7.3网络地图瓦片服务

7.3.1服务介绍

时空云平台网络地图瓦片服务（WebMapTileService，简称WMTS）是通过指定参数获取指定位

置的地图瓦片的服务。服务器端预先按照规定格式生成瓦片，客户端通过指定参数获取指定位置的地图

瓦片，该服务可以缓解WebGIS服务器端数据处理的压力，提高交互响应速度，大幅改善在线地图应用

客户端的用户体验。

7.3.2操作列表

网络地图瓦片服务接口包括GetCapabilities、GetTile和GetFeatureInfo等操作，详见表14。

表14网络地图瓦片服务接口操作列表

编号操作说明

1GetCapabilities获取WMTS的能力文档（即元数据文档，XML形式），里面包含服务的所有信息

2GetTile根据客户端发出的请求参数在服务端进行检索，返回地图瓦片图像。

3GetFeatureInfo通过在WMTS图层上指定一定的条件，返回指定的地图瓦片内容对应的要素信息

7.3.3参数说明

网络地图瓦片服务接口操作请求参数说明见表15至表17。

表15GetCapabilities操作请求参数

参数名称DB4401说明

service字符型（Char4），服务类型值为“WMTS”

request字符型（Char20），请求的操作名称，值为“GetCapabilities”

acceptVersions字符型（Char4），请求的WMTS的版本号

字符型（Char500），请求元数据文档多个节的名称，多个名称之间用“，”隔开，无需按顺序

sections

排列。值为空默认返回整个元数据文档

updateSequence字符型（Char500），值为increased，为空时默认返回最新的元数据文档

表16GetTile操作请求参数

参数名称说明

service字符型（Char4），服务类型值为“WMTS”

request字符型（Char20），请求的操作值为“GetTile”

version字符型（Char4），请求的WMTS的版本号

layer字符型（Char32），请求的图层名称

7

DB4401/T222.1—2023

表16GetTile操作请求参数（续）

参数名称说明

style字符型（Char32），请求图层的渲染样式

format字符型（Char5），瓦片地图的输出格式

tileMatrixSet字符型（Char32），瓦片矩阵数据集，其值在服务的元数据文档中指定

tileMatrix字符型（Char32），瓦片矩阵，其值在服务的元数据文档中指定

tileRow整数型（Int），值为大于0的整数，表示瓦片矩阵的行号

tileCol整数型（Int），值为大于0的整数，表示瓦片矩阵的列号

表17GetFeatureInfo操作请求参数

参数名称说明

service字符型（Char4），服务类型值为“WMTS”

request字符型（Char20），请求的操作值为“GetFeatureInfo”

version字符型（Char4），请求的WMTS的版本号

J整数型（Int），值为大于0的整数，表示瓦片上一指定像素点的行号

I整数型（Int），值为大于0的整数，表示瓦片上一指定像素点的列号

layer字符型（Char32），请求的图层名称

style字符型（Char32），请求图层的渲染样式

info_formatMIME类型，值为请求信息的返回类型

format字符型（Char5），瓦片地图的输出格式

tileMatrixSet字符型（Char32），瓦片矩阵数据集，其值在服务的元数据文档中指定

tileMatrix字符型（Char32），瓦片矩阵，其值在服务的元数据文档中指定

tileRow整数型（Int），值为大于0的整数，表示瓦片矩阵的行号

tileCol整数型（Int），值为大于0的整数，表示瓦片矩阵的列号

7.3.4调用示例

网络地图瓦片服务接口调用示例参见附录A.10至A.12。

7.4网络地图服务

7.4.1服务介绍

时空云平台网络地图服务（WebMapService，简称WMS）是通过指定参数动态生成地图图片的

服务。服务器按照客户端请求的参数，动态生成地图图片并返回给客户端，这些地图通常用GIF、JPEG

或PNG等图像格式，或者SVG、KML、VML和WebCGM等矢量图形格式来表现。

7.4.2操作列表

网络地图服务接口包括GetCapabilities、GetMap和GetFeatureInfo等操作，详见表18。

表18网络地图服务接口操作列表

编号操作说明

1GetCapabilities获取WMS的能力文档（即元数据文档，XML形式），里面包含服务的所有信息

2GetMap根据客户端发出的请求参数在服务端进行检索，服务器端返回一个地图图像

8

DB4401/T222.1—2023

表18网络地图服务接口操作列表（续）

编号操作说明

3GetFeatureInfo根据用户所请求的X、Y坐标或感兴趣的图层，返回地图上某些特殊要素的信息

7.4.3参数说明

网络地图服务接口操作请求参数说明见表19至表21。

表19GetCapabil