DB4403-T 91-2020 地理空间信息服务接口规范-（高清现行）

ICS07.040A75

DB4403深 圳 市 地 方 标 准DB4403/T91—2020地理空间信息服务接口规范Specificationforgeospatialinformationinterfaceservice2020-09-292020-09-292020-11-01深圳市市场监督管理局发布目 次前言 II引言 III1范引文件 1语定义 1略语 3务类 3口本定 4请协议 4交格式 5务口求 5专数据API 5三专数据API 5三数据API 5空分析API 6地地址API 6场图层API 6建信查询API 7附录A（范附）服务口范 8参考献 15前 言本标准按照GB/T1.1—2009给出的规则起草。本标准由深圳市规划和自然资源局提出并归口。本标准起草单位：深圳市规划国土房产信息中心(深圳市空间地理信息中心)。引 言地理空间信息服务接口规范范围本规范规定了深圳市地理空间信息服务分类、服务接口基本规定、服务接口要求等。本规范适用于深圳市地理空间信息服务资源获取、分发、二次开发以及服务扩展与维护等。GB/T30169地理信息基于网络的要素服务GB/T35652瓦片地图服务OGC04-094WebFeatureServiceImplementationSpecificationOGC06-042WebMapServiceImplementationSpecificationOGC07-057r7OpenGISWebMapTileServiceImplementationStandard3术语和定义3术语和定义下列术语和定义适用于本标准。3.1地理空间信息geospatialinformation直接或间接与地球位置相关联的现象的有关信息。3.2坐标coordinateN3.3坐标参考系统coordinatereferencesystem通过基准与显示世界相关的坐标系。3.4要素feature代表物理实体的，具有几何形状的地图元素。3.5瓦片tile地图数据根据一定规则切分为的若干数据单元。3.6地理编码geocoding地址匹配address-matching采用标准化的编码格式表示的地表、地下或者空中的地理空间点在特定时间的确切位置的测量信息。可理解为建立地理位置坐标与给定地址一致性的过程，即指在地图上找到并标明每条地址所对应的位置。3.7接口interface两个功能单元共享的边界，由各种特征来定义。服务service由实体通过接口提供的明确功能。3.9服务service由实体通过接口提供的明确功能。3.9空间分析spatialanalysis基于地理对象的位置和形态特征的数据分析技术，其目的在于提取和传输空间信息。3.10缓冲区分析bufferanalysis3.11叠加分析overlayanalysis将两层或多层地图要素进行叠加产生一个新要素层的操作，其结果将原来要素分割生成新的要素，新要素综合了原来两层或多层要素所具有的属性，并形成新的空间关系和新的属性关系。3.12地名geographicalnames用于表征具体地理实体的专用名称。示例：3.13地址address对某一特定空间位置上自然或人文地理实体位置名称的结构化描述。示例：深圳市福田区红荔路8009号。3.14标准地址standardaddress符合特定地址标准、按照指定规则进行描述的地址，包含行政区划信息、村区信息、街路巷、小区信息、建筑物及单元、楼层、户室等信息。3.15数据集dataset同一类要素数据组成的集合。同一类要素数据组成的集合。4缩略语API：应用程序编程接口(ApplicationProgrammingInterface)B3DM：批处理三维模型(Batched3DModel)JSON：JavaScript对象简谱(JavaScriptObjectNotation)PNG：便携式网络图形(PortableNetworkGraphicFormat)OGC：开放地理空间信息联盟(OpenGeospatialConsortium)WFS：网络要素服务(WebFeatureService)WMS：网络地图服务(WebMapService)WMTS：网络地图切片服务(WebMapTileService)SLPK：场景图层包(SceneLayerPackage)S3M：空间三维模型(Spatial3DModel)URL：统一资源定位符（UniformResourceLocator）XML：可扩展标记语言（eXtensibleMarkupLanguage）5服务分类APIAPIAPIAPIAPI、APIAPIAPI。服务分类见表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缓冲区分析API缓冲区分析服务7.4.1叠加分析API叠加分析服务7.4.2地址匹配API地址正向匹配API地址正向匹配服务按7.5.1的要求地址逆向匹配API地址逆向匹配服务按7.5.2的要求场景图层API场景图层API场景图层目录服务按7.6的要求建筑信息查询API建筑信息查询API建筑信息查询7.76接口基本规定6接口基本规定6.1请求协议采用HTTP或HTTPS协议。请求方式为GET或POST请求。6.2交换格式交换格式如表2所示。表2交换格式名称说明JSON空间分析API、地名地址API等采用此交换格式。XMLWMS、WMTS、WFS等服务的元数据访问接口返回此交换格式。PNGWMS、WMTS等服务的地图瓦片访问接口返回此交换格式B3DM三维数据服务(3DTiles)访问接口返回此交换格式。SLPK三维数据服务(I3S)访问接口返回此交换格式。S3MB三维数据服务(S3M)访问接口返回此交换格式。API网络地图API接口应符合OGC06-042要求。API网络地图API接口应符合OGC06-042要求。API网络地图切片API接口应符合OGC07-057r7和GB/T35652要求。API网络要素API接口应符合OGC04-094和GB/T30169要求。APIAPI三维元数据API可根据三维场景、图层名称、服务类型(其中服务类型包含3DTiles，I3S，S3M等类型)查询图层元数据和配置等信息。该接口通过GET方式请求场景名称、图层名称和服务类型，服务接口返回接口访问状态、访问说明和服务地址等信息。请求参数及返回结果应遵照附录A中A.1的要求。API三维瓦片数据API可根据三维场景名称、图层名称、服务类型、文件路径得到对应的三维瓦片数据文件信息，返回客户端对应的服务文件。该接口通过GET方式请求，请求场景名称、图层名称、服务类型、文件路径，返回对应的文件(B3DM，SLPK，S3MB等)。请求参数应遵照附录A中A.2的要求。APIAPI该服务提供缓冲区分析功能。缓冲区分析功能，支持用户根据指定的距离，在点、线、面几何对象周围自动建立一定宽度的区域。该接口支持对指定的某个几何对象做缓冲区分析，通过设置缓冲区半径等参数，形成缓冲区面。POSTAA.3API该服务提供叠加分析功能。叠加分析功能，支持用户对点、线、面类型数据集进行集合运算，如裁剪、合并、擦除、求交、同一、对称差、更新等。该接口支持对指定的某两个几何对象做叠加分析，通过参数设置可以指定要做叠加分析的几何对POSTAA.4API地址正向匹配API该接口支持将结构化地址(省/市/区/街道/门牌号)解析为对应的位置坐标同时也支持模糊的查询POST果应遵照附录AA.5地址逆向匹配APIPOST数和返回结果应遵照附录AA.6APIGET或POSTAA.7建筑信息查询APIGET或POST中A.8附录A（规范性附录）服务接口规范API参数请求参数如表A.1。表A.1三维元数据API请求参数请求参数是否必须类型参数说明sceneName是String场景名称layerName是String图层名称serviceType是String服务类型(3DTiles、I3S、S3M等)token否String认证token返回结果参数如表A.2。表A.2三维元数据API返回参数A.2三维瓦片数据API参数返回结果参数如表A.2。表A.2三维元数据API返回参数A.2三维瓦片数据API参数A.2.1请求参数请求参数如表A.3。表A.3三维瓦片数据API请求参数返回参数类型参数说明msgString访问说明，请求结果描述codeInt状态码，请求结果编码，0表示成功，其它数字为错误编码successBoolen访问状态，请求是否成功srsString坐标参考系统dataUrlString服务地址extendString用户扩展信息请求参数是否必须类型参数说明sceneName是String场景名称layerName是String图层名称serviceType是String服务类型A.3.2返回结果A.3.2返回结果返回结果参数如表A.5。表A.5缓冲区分析API返回参数A.3.3lists参数lists参数如表A.6。表A.3（续）请求参数是否必须类型参数说明path是String文件路径(B3DM、SLPK、S3M等)token否String认证tokenA.2.2返回结果返回结果为三维瓦片数据。API参数请求参数如表A.4。表A.4缓冲区分析API请求参数请求参数是否必须类型参数说明endType否String缓冲区端点枚举值默认值：FLAT可选值：FLAT、ROUNDleftDistance否Float左侧缓冲距离，默认值：100rightDistance否Float右侧缓冲距离，默认值：100semicircleLineSegment否Int圆头缓冲圆弧处线段的个数。默认值：4radiusUnit否String缓冲半径单位，默认值：METER可选值：CENTIMETER，DECIMETER，KILOMETERMETERsourceGeometry是Array<Object>分析对象坐标串token否String认证token返回参数类型参数说明msgString访问说明，请求结果描述codeInt状态码，请求结果编码，0表示成功，其它数字为错误编码successBoolen访问状态，请求是否成功srsString坐标参考系统listsArray<Object>结果集，参数详见表A.6A.4.2返回结果返回结果参数如表A.8。A.4.2返回结果返回结果参数如表A.8。表A.8叠加分析API返回参数A.4.3lists参数lists参数如表A.9。表A.9lists参数样例表A.6lists返回参数类型参数说明latFloat纬度值lngFloat经度值extendString用户扩展信息API请求参数如表A.7。表A.7叠加分析API请求参数请求参数是否必须类型参数说明operateGeometry是String叠加分析的操作几何对象，分析对象坐标串sourceGeometry是Array<Object>叠加分析的源几何对象，分析对象坐标串operateGeometries否Array<operateGeometry>批量叠加分析的操作几何对象数组sourceGeometries否Array<sourceGeometry>批量叠加分析的源几何对象数组operation否String叠加操作枚举值，可选值为：CLIP，ERASE，INDENTITY，INTERSECT，UNION，UPDATE，XORtoken否String认证token返回参数类型参数说明msgString访问说明，请求结果描述codeInt状态码，请求结果编码，0表示成功，其它数字为错误编码successBoolen访问状态，请求是否成功srsString坐标参考系统listsArray<Object>结果集，参数详见表A.9返回参数类型参数说明fieldNamesFloat字段名表A.9（续）返回参数类型参数说明fieldValuesArray<String>字段值，顺序与fieldNames一致pointsString几何体点串extendString用户扩展信息API请求参数如表A.10。表A.10地址正向匹配API请求参数请求参数是否必须类型参数说明token是String认证tokenaddr是String待匹配的地址page否Int结果分页参数，分页页码，默认值：1limit否Int结果分页参数，每页结果数，默认值：10fuzzy否Boolen是否模糊匹配，false模糊匹配，不要求待匹配地址每个字都出现在结果中。和equal参数不可同时使用equal否Boolen是否完全匹配，falsetruetruefuzzy数不可同时使用where否Array<Object>自定义查询条件参数A.5.2返回结果A.5.2返回结果返回结果参数如表A.11。表A.11地址正向匹配API返回参数样例返回参数类型参数说明msgString访问说明，请求结果描述codeInt状态码，请求结果编码，0表示成功，其它数字为错误编码successBoolen访问状态，请求是否成功dataJsonObject返回的结果数据countInt搜索结果总数addrListArray<Object>结果列表codeString结果地址对应的标准地址编码addrString结果地址lvInt地址层级(1.省2.市3.区4.街道5.社区6.道路7.门牌8.小区9.楼栋10.单元11.房间)scoreFloat匹配度，分值越大，服务对地址理解程度越高表A.11（续）返回参数类型参数说明srsString坐标参考系统locgeojson匹配坐标shapegeojson地址空间面信息provinceString省cityString市districtString区streetString街道communityString社区roadString道路road_numString门牌villageString小区buildingString楼栋building_numString单元house_numString房间room_floorInt房间所属楼层extendString用户扩展信息A.6.1请求参数请求参数如表A.12。表A.12逆向匹配API请求参数A.6.2返回结果返回结果参数如表A.13。A.6.1请求参数请求参数如表A.12。表A.12逆向匹配API请求参数A.6.2返回结果返回结果参数如表A.13。表A.13逆向匹配API返回参数请求参数是否必须类型参数说明token是String认证tokenlat是Float纬度值lng是Float经度值top否Int返回结果条数，按匹配度排序前多少条进行返回，默认值：1返回参数类型参数说明msgString访问说明，请求结果描述codeInt状态码，请求结果编码，0表示成功，其它数字为错误编码successBoolen访问状态，请求是否成功listsArray<Object>结果集，参数详见表A.14A.6.3lists参数lists参数如表A.14。表A.14lists返回参数类型参数说明addressString匹配地址scoreFloat匹配度，分值越大，服务对地址理解程度越高API请求参数如表A.15。A.7.2返回结果返回结果参数如表A.16。表A.16场景图层API返回参数A.7.2返回结果返回结果参数如表A.16。表A.16场景图层API返回参数A.7.3datadata参数如表A.17。表A.17data参数样例请求参数是否必须类型参数说明groupType是Int分组类型sceneType是String场景类型(2D，3D，地下空间等)token否String认证token返回参数类型参数说明msgString访问说明，请求结果描述codeInt状态码，请求结果编码，0表示成功，其它数字为错误编码successBoolen访问状态，请求是否成功dataArray<Object>返回的结果数据，参数详见表A.17返回参数类型参数说明idInt编码parentIdIn