地理空间信息服务接口规范docx.docx

地理空间信息服务接口规范docx.docx

《地理空间信息服务接口规范docx.docx》由会员分享，可在线阅读，更多相关《地理空间信息服务接口规范docx.docx（22页珍藏版）》请在冰豆网上搜索。

地理空间信息服务接口规范docx

ICS07.040

A75

DB4403

深圳市地方标准

DB4403/T91—2020

地理空间信息服务接口规范

Specificationforgeospatialinformationinterfaceservice

2020-09-29发布2020-11-01实施

深圳市市场监督管理局发布

目次

前言II

引言III

1范围1

2规范性引用文件1

3术语和定义1

4缩略语3

5服务分类3

6接口基本规定4

6.1请求协议4

6.2交换格式5

7服务接口要求5

7.1地图数据API5

7.2专题数据API5

7.3三维数据API5

7.4空间分析API6

7.5地名地址API6

7.6场景图层API6

7.7建筑信息查询API7

附录A（规范性附录）服务接口规范8

参考文献15

本标准按照GB/T1.1—2009给岀的规则起草。

本标准由深圳市规划和自然资源局提岀并归口。

本标准起草单位：

深圳市规划国土房产信息中心（深圳市空间地理信息中心）。

本标准主要起草人：

张健、孙薇、王湛、彭子凤、杨文龙、张曼平、刘江涛、张杰、陈伟、龙琳、唐李、王存进、熊梓言、韩赛、杨建峰、黄晓涵、梁铭、喻婷、王成、马露德、任玲、孙海龙、孙思聪、邱国柱、汪靖韬、张东杰、杨晨、万炜、胡思粤、孔妮荣。

地理空间信息是城市重要战略信息资源，在政府管理决策、新兴产业发展、人民生活改善等方面发挥着越来越重要的作用。

随着深圳市数字政府和智慧城市建设的不断推进，各级政府部门和社会公众跨部门、跨领域和跨行业的地理空间信息服务需求与日俱增。

为规范深圳市地理空间信息公共服务接口，促进地理空间信息在各级用户之间的共享与衔接，特制定本标准。

地理空间信息服务接口规范

1范围

本规范规定了深圳市地理空间信息服务分类、服务接口基本规定、服务接口要求等。

本规范适用于深圳市地理空间信息服务资源获取、分发、二次开发以及服务扩展与维护等。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。

凡是注日期的引用文件，仅注日期的版本适用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T30169地理信息基于网络的要素服务

GB/T35652瓦片地图服务

OGC04—094WebFeatureServiceImplementationSpecification

OGC06—042WebMapServiceImplementationSpecification

OGC07—057r7OpenGISWebMapTileServiceImplementationStandard

3术语和定义

下列术语和定义适用于本标准。

3.1

地理空间信息geospatiaIinformation

直接或间接与地球位置相关联的现象的有关信息。

3.2

坐标coordinate

用来指示N维空间中点的位置的数值序列。

3.3

坐标参考系统coordinatereferencesystem

通过基准与显示世界相关的坐标系。

3.4

要素feature

代表物理实体的，具有几何形状的地图元素。

3.5

瓦片tile

地图数据根据一定规则切分为的若干数据单元。

3.6

地理编码geocoding

地址匹配address-matching

采用标准化的编码格式表示的地表、地下或者空中的地理空间点在特定时间的确切位置的测量信息。

可理解为建立地理位置坐标与给定地址一致性的过程，即指在地图上找到并标明每条地址所对应的位置。

3.7

接口interface

两个功能单元共享的边界，由各种特征来定义。

3.8

月艮务service

由实体通过接口提供的明确功能。

3.9

空间分析spatiaIanalysis

基于地理对象的位置和形态特征的数据分析技术，其目的在于提取和传输空间信息。

3.10

缓冲区分析bufferanalysis

对选中的一组或一类地图要素（点、线或面）按设定的距离条件,围绕其要素而形成一定缓冲区多边形实体，从而实现数据在二维空间得以扩展的信息分析方法。

3.11

叠力口分析overIayanalysis

将两层或多层地图要素进行叠加产生一个新要素层的操作，其结果将原来要素分割生成新的要素，新要素综合了原来两层或多层要素所具有的属性，并形成新的空间关系和新的属性关系。

3.12

地名geographicalnames

用于表征具体地理实体的专用名称。

示例：

洞、公路、河流、湖、潭、环岛、纪念地、建筑物、交通场站、街巷、开发区、名胜古迹、桥梁、泉、山峰、山脉、水库、水渠、隧道、体育设施、铁路、政区、住宅区、自然村等。

3.13

地址address

对某一特定空间位置上自然或人文地理实体位置名称的结构化描述。

示例：

深圳市福田区红荔路8009号。

3.14

标准地址standardaddress

符合特定地址标准、按照指定规则进行描述的地址，包含行政区划信息、村区信息、街路巷、小区信息、建筑物及单元、楼层、户室等信息。

3.15

数据集dataset

同一类要素数据组成的集合。

4缩略语

API：

应用程序编程接口（ApplicationProgrammingInterface）

B3DM：

批处理三维模型（Batched3DModel）

JSON：

JavaScript对象简谱（JavaScriptObjectNotation）

PNG：

便携式网络图形（PortableNetworkGraphicFormat）

OGC：

开放地理空间信息联盟（OpenGeoroatialConsortium）

WFS：

网络要素服务（WebFeatureSer5ice）

WMS：

网络地图服务（WebMapService）

WMTS：

网络地图切片服务（WebMapTileService）

SLPK：

场景图层包（SceneLayerPackage）

S3M：

空间三维模型（Spatial3DModel）

URL：

统一资源定位符（UniformResourceLocator）

XML：

可扩展标记语言（extensibleMarkupLanguage）

5服务分类

按照服务的性质将地理空间信息服务划分为数据服务和功能服务。

数据服务通过相应API接口对外提供，按实现技术上划分为地图数据API、专题数据API、三维数据API；功能服务划分为空间分析API、地址匹配API、场景图层API、建筑信息查询API。

服务分类见表1。

表1服务类目表

一级类目

二级类目

三级类目

服务提供方式

数据服务

地图数据API

网络地图API

地图服务WMS

（WebMapService）

按7.1.1的要求

网络地图切片API

地图切片服务WMTS

（WebMapTileService）

按7.1.2的要求

专题数据API

网络要素API

网络要素服务WFS

（WebFeatureService）

按7.2的要求

三维数据API

三维元数据API

三维元数据服务

按7.3.1的要求

三维瓦片数据API

三维瓦片数据服务

按7.3.2的要求

功能服务

空间分折

缓冲区分析API

缓冲区分析服务

按7.4.1的要求

叠加分析API

叠加分析服务

按7.4.2的要求

地址匹配API

地址正向匹配API

地址正向匹配服务

按7.5.1的要求

地址逆向匹配API

地址逆向匹配服务

按7.5.2的要求

场景图层API

场景图层API

场景图层目录服务

按7.6的要求

建筑信息查询API

建筑信息查询API

建筑信息查询

按7.7的琴亲

6接口基本规定

6.1请求协议采用HTTP或HTTPS协议。

请求方式为GET或POST请求。

6.2交换格式

交换格式如表2所示。

表2交换格式

名称

说明

JSON

空间分析API、地名地址API等采用此交换格式。

XML

WMS、WMTS、WFS等服务的元数据访问接口返回此交换格式。

PNG

WMS、WMTS等服务的地图瓦片访问接口返回此交换格式

B3DM

三维数据服务（3DTiles）访问接口返回此交换格式。

SLPK

三维数据服务（I3S）访问接口返回此交换格式。

S3MB

三维数据服务（S3M）访问接口返回此交换格式。

7服务接口要求

7.1地图数据API

7.1.1网络地图API

网络地图API接口应符合OGC06-042要求。

7.1.2网络地图切片API

网络地图切片API接口应符合OGC07-057r7和GB/T35652要求。

7.2专题数据API

网络要素API接口应符合OGCU。

94和GB/T30169要求。

7.3三维数据API

7.3.1三维元数据API

三维元数据API可根据三维场景、图层名称、服务类型（其中服务类型包含3DTiles,I3S,S3M等类型）查询图层元数据和配置等信息。

该接口通过GET方式请求场景名称、图层名称和服务类型，服务接口返回接口访问状态、访问说明和服务地址等信息。

请求参数及返回结果应遵照附录A中A.1的要求。

7.3.2三维瓦片数据API

三维瓦片数据API可根据三维场景名称、图层名称、服务类型、文件路径得到对应的三维瓦片数据文件信息，返回客户端对应的服务文件。

该接口通过GET方式请求，请求场景名称、图层名称、服务类型、文件路径，返回对应的文件（B3DM,SLPK，S3MB等）。

请求参数应遵照附录A中A.2的要求。

7.4空间分析API

7.4.1缓冲区分析API

该服务提供缓冲区分析功能。

缓冲区分析功能，支持用户根据指定的距离，在点、线、面几何对象周围自动建立一定宽度的区域。

该接口支持对指定的某个几何对象做缓冲区分析，通过设置缓冲区半径等参数，形成缓冲区面。

该接口通过POST方式请求分析对象坐标串、缓冲区半径、单位等，服务接口返回接口访问状态、访问说明和结果集，结果集中包含分析结果。

请求参数和返回结果应遵照附录A中A.3的要求。

7.4.2叠加分析API

该服务提供叠加分析功能。

叠加分析功能，支持用户对点、线、面类型数据集进行集合运算，如裁剪、合并、擦除、求交、同一、对称差、更新等。

该接口支持对指定的某两个几何对象做叠加分析，通过参数设置可以指定要做叠加分析的几何对象、叠加操作类型。

该接口通过POST方式请求叠加的几何对象和叠加类型等，服务接口返回接口访问状态、访问说明、空间参考系统和结果集，结果集中包含分析结果。

请求参数和返回结果应遵照附录A中A.4的要求。

7.5地名地址API

7.5.1地址正向匹配API

该接口支持将结构化地址（省/市/区/街道/门牌号）解析为对应的位置坐标同时也支持模糊的查询方式。

该接口通过POST方式请求待匹配的地址等信息，服务接口返回接口访问状态、访问说明、状态码和结果集，结果集中包含匹配坐标、匹配度、地址空间面信息、匹配层级等信息。

请求参数和返回结果应遵照附录A中A.5的要隶…

7.5.2地址逆向匹配API

该接口支持将位置坐标解析成对应的地址信息。

，该接口通过POST方式请求待匹配的坐标和返回记录条数，服务接口返回接口访问状态、访问说明和结果集＜第果集中包含匹配地址和匹配度。

请求参数和返回结果应遵照附录A中A.6的要求。

7.6场景图层API

该接口支持通过图层的分组和场景类型过滤岀应用场景所需要的图层目录树。

该接口通过GET或POST方式请求场景类型等信息，返回接口访问状态、访问说明、状态码和结果集，结果集包含编码、所属父编码、图层名称、图层别名、服务地址、空间参考系统、服务类型等信息。

请求参数和返回结果应遵照附录A中A.7的要求。

7.7建筑信息查询API

该接口支持通过地理位置（经纬度）和模型属性查询。

该接口通过GET或POST方式请求纬度值、经度值等信息，返回接口访问状态、访问说明、状态码和结果集，结果集中包含模型编码、模型名称、所属区域、模型地址、状态、模型高度等信息。

请求参数和返回结果应遵照附录A中A.8的要求。

附录A

（规范性附录）

服务接口规范

A.1三维元数据API参数

A.1.1请求参数

请求参数如表A.1。

表A.1三维元数据API请求参数

请求参数

是否必须

类型

参数说明

sceneName

是

String

场景名称

layerName

是

String

图层名称

serviceType

是

String

服务类型（3DTiles、I3S、S3M等）

token

否

String

认证token

A.1.2返回结果

返回结果参数如表A.2„

表A.2三维元数据API返回参数

返回参数

类型

参数说明

msg

String

访问说明，请求结果描述

code

Int

状态码，请求结果编码，0表示成功，其它数字为错误编码

success

Boolen

访问状态，请求是否成功

srs

String

坐标参考系统

dataUrl

String

服务地址

extend

String

用户扩展信息

A.2三维瓦片数据API参数

A.2.1请求参数

请求参数如表A.3„

表A.3三维瓦片数据API请求参数

请求参数

是否必须

类型

参数说明

sceneName

是

String

场景名称

layerName

是

String

图层名称

serviceType

是

String

服务类型

表A.3（续）

请求参数

是否必须

类型

参数说明

path

是

String

文件路径（B3DM、SLPK、S3M等）

token

否

String

认证token

A.2.2返回结果

返回结果为三维瓦片数据。

A.3缓冲区分析API参数

A.3.1请求参数

请求参数如表A.4。

表A.4缓冲区分析API请求参数

请求参数

是否必须

类型

参数说明

endType

否

String

缓冲区端点枚举值默认值：

FLAT可选值：

FLAT、ROUND

leftDistance

否

Float

左侧缓冲距离，默认值：

100

rightDistance

否

Float

右侧缓冲距离，默认值：

100

semicircleLineSegment

否

Int

圆头缓冲圆弧处线段的个数。

默认值：

4

radiusUnit

否

String

缓冲半径单位，默认值：

METER

可选值：

CENTIMETER,DECIMETER,KILOMETER,

WETER

sourceGeometry

是

Array<0bject>

分析对象坐标串

token

否

String

认证token

A.3.2返回结果

返回结果参数如表A.茶

表A.5緩冲区分析API返回参数

返回参数

类型

参数说明

msg

String

访问说明，'晶条结果噴述1

code

Int

状态码，请求结果命马，0表芫成功，其它数字为错误编码

success

Boolen

访问状态，请求是否成功

srs

String

坐标参考系统

lists

Array<0bject>

结果集，参数详见表A.6

A.3.3lists参数

lists参数如表A.6„

表A.6lists参数样例

返回参数

类型

参数说明

lat

Float

纬度值

lng

Float

经度值

extend

String

用户扩展信息

A.4叠加分析API参数

A.4.1请求参数

请求参数如表A.7。

表A.7叠加分析API请求参数

请求参数

是否必须

类型

参数说明

operateGeometry

是

String

叠加分析的操作几何对象,分析对象坐标串

sourceGeometry

是

Array