CHT 9027-2018 数字城市地理信息公共平台服务接口

数字城市地理信息公共平台服务接口for中华人民共和国自然资源部发布 l 2规范性引用文件 3术语和定义 4缩略语 25基本服务接口 35.1数据目录服务接口 5.2数据发布服务接口 75.3数据操作服务接口 5.4数据分析服务接口 205.5服务接口用例 6扩展服务接口 28 28附录A(资料性附录)服务接口用例 参考文献 本标准的起草规则依据GB/T1.1—2009。本标准由中华人民共和国自然资源部提出并归口。本标准起草单位：武汉大学、中国测绘科学研究院、天津市测绘院、东华理工大学。Ⅱ为推动数字城市地理信息公共平台的建设，明确数字城市地理信息公共平台的基本服务及服务接口的基本要求，实现异构应用系统及不同行业间有关地理数据共享和功能的互操作，制定本标准。1数字城市地理信息公共平台服务接口1范围本标准规定了数字城市地理信息公共平台中基本服务及扩展服务的接口实现方法。木标准适用于数字城市地理信息公共平台建设与应用。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T19710—2005地理信息元数据GB/T23708地理信息地理标记语言(GML)GB/T25597—2010地理信息万维网地图服务接口GB/T30169—2013地理信息基于网络的要素服务3术语和定义下列术语和定义适用于本文件。数字城市地理信息公共平台commonplatformforgeospatialinformationserviceofdigitalcity依托基础地理信息标准数据，通过在线地理信息服务满足城市政府部门、企事业单位和社会公众的基本需求，具备实现个性化应用的二次开发接口和可扩展空间。它是各种专业信息空间定位、集成交换和互联互通的基础，也是数字城市地理空间框架的重要组成部分。在本标准中，简称“公共平台”。向用户提供转换、管理或表示地理信息的服务。地理要素geographicfeature与地球上地点相关的现实世界现象的表达。操作operation对象可以被调用执行的转换和查询的规范。描述实体行为特征的命名操作(3.4)集合。2实体通过接口(3.5)提供的功能的可区分部分。数据到一系列代码的转换。服务器server服务(3.6)的特定实例。元数据metadata关于数据的数据。客户端client能从服务器(3.8)调用操作(3.4)的软件组件。将指定范围的地图按照指定尺寸和指定格式，切成若干行及列的矩形图片。通常情况下，这些图片覆盖空间上连片的范围，共用相同的信息内容和图式符号，分别具有唯一标识。通过客户端(3.10)发出的操作(3.4)的要求。由服务器(3.8)返回给客户端(3.10)的操作(3.4)结果。4缩略语下列缩略语适用于本文件。CSW数据目录服务(catalogueservicefortheweb)GML地理标记语言(geographymarkuplanguage)KVP键值对(keywordvaluepair)MIME多用途互联网邮件扩展(multipurposeinternetmailextensions)OWS网络服务通用规范(OGCwebservicescommonstandard)3WCS网络覆盖服务(webcoverageservice)WFS网络要素服务(webfeatureservice)WMS网络地图服务(webmapservice)WMTS网络地图瓦片服务(webmaptileservice)WPS网络处理服务(webprocessingservice)UML统一建模语言(unifiedmodelinglanguage)URI统一资源标识符(uniformresourceidentifier)URL统一资源定位器(uniformresourcelocator)5基本服务接口5.1数据目录服务接口5.1.1接口函数数据目录服务接口函数见表1。表1数据目录服务接口函数函数名元数据文档中包含描述服务性能的元数据信息以及该服务支持的操作、提供的数据集等信息用于搜索目录内容，返回所有满足条件的结果返回指定类型的取值范围以推送(push)的方式，允许客户对目录内以拉取(pull)的方式提供对远程资源的获数据目录服务接口UML类图见图1。4-Rcqust:string=GdtCapAcceplFormaisstringtexl/xml数据目录履务接口-DescriheRecwrdfinReyaest:DescribeReunlReGetRecoris(inReqaest:GetRecorGetRecorubytdfinRequest:CiefRecortlbwdRegaestjCielomoin(mNequest:Cielomain/equestj-Trumsaclion(inReqest:TrmsuciomReHmnwsReast;HrvesiReyuext网络通用服务接口GieCapahilities(inRegwes:CieatqnahiltiesRegnesl):ServicePmpertyName"string+OpcrationsMetadata:Request:stringDescribeRecondITypeNanes:stringGetCapabilities操作包含请求信息与响应内容两方面。a)请求：请求关于描述该服务的元数据信息，包括服务的基本信息、服务支持的操作信息和服务支持的数据集元数据信息。具体请求参数描述见表2。参数名数据类型取值范围字符串字符串名为GetCapabilities字符串一组服务版本号代号。或服务器不支持则返回最新字符串或服务器不支持则返回完整的文档字符串返回响应文档类型的b)响应：返回一个描述服务能力的文档。根据请求参数Sections容(Serviceldentification,ServiceProvider,OperationsMetadata构成服务能力描述文档。各部分内容见表3。的定义，选取并组合四项描述内和Contents)中的一项或多项，5参数名实现OWS规范的服务在这一部分内容和结构是一致的网站服务者的信息等。所有实现OWS规范的服务在这一部分内容和结构是一致的服务所有实现的操作的元数据信息，包括操作请求的URL地址、服务数据、操作参数的有效值域等。所有实现OWS规范的服务在这一部分内容由具体实现的服务定义描述服务提供的数据的元数据信息。不同的实现OWS规范的服务在这一部分内容和结构DescribeRecord操作包含请求信息与响应内容两方面。a)请求：请求指定名称的已注册服务的类型、内容等详细描述信息。具体请求参数描述见表4。表4DescribeRecord操作请求参数描述参数名数据类型取值范围字符串字符串字符串字符串可选参数。默认值为返回b)响应：返回已注册服务相关内容的详细描述文档。GetRecords操作包含请求信息与响应内容两方面。a)请求：请求所有满足条件的已注册服务。具体请求参数描述见表5。表5GetRecords操作请求参数描述参数名数据类型取值范围字符串字符串名为GetRecords字符串6参数名数据类型取值范围目录服务信息查询实体字符串字符串brief,summary或full字符串字符串制条件查询b)响应：返回描述符合条件的已注册服务的文档。GetRecordbyld操作包含请求信息与响应内容两方面。a)请求：根据注册对象的Id号请求满足条件的已注册服务。具体请求参数描述见表6。表6GetRecordbyId操作请求参数描述参数名数据类型取值范围字符串字符串字符串字符串b)响应：返回描述符合条件的已注册服务的文档。GetDomain操作包含请求信息与响应内容两方面。a)请求：请求某一参数或属性的值域范围。具体请求参数描述见表7。参数名数据类型取值范围字符串字符串字符串请求的接口参数名字符串ProperyName二者选其一请求的属性名字符串7b)响应：返回描述指定接口参数或属性的值域范围的文档。Transaction操作包含请求信息与响应内容两方面。a)请求：请求注册远程服务资源。以推送(push)的方式，允许客户对目录内容进行插入、删除及更新的操作。具体请求参数描述见表8。表8Transaction操作请求参数描述参数名数据类型取值范围字符串字符串字符串添加注册信息字符串修改注册信息字符串字符串注：Transaction操作不支持KVP编码请求。b)响应：根据请求参数返回描述操作反馈信息的文档。Harvest操作包含请求信息与响应内容两方面。a)请求：请求注册远程服务资源，以拉取(pull)的方式获取远程服务资源，并在目录中注册。具体请求参数描述见表9。参数名数据类型取值范围字符串字符串名为Harvest字符串引用的元数据源位置b)响应：返回描述操作反馈信息的文档。5.2数据发布服务接口WMS服务接口规范参照GB/T25597—2010。85.2.2WFS服务接口WFS服务接口规范参照GB/T30169—2013。WCS服务接口函数见表10。表10WCS服务接口函数函数名获取服务实现规范描述自身能力的元数据文档信息以特定的格式获取所需的Coverage数据WCS服务接口UML类图见图2。Rcqucst:string=GetCapabi-AaceptFormats:stringWCs服务接口-DesenheCoverceefmReyuest:DescriheCnvercgeRegnest):DescrtheCmerogeResponse-GenComerageftnReyiew:GenCmenegeRecates)+Request:stringDesaribeCoveageRequst:sting=GietCov网络通用服务接口Gercporhlitisfiteyest:GiencnshthhiesfRens):SemiceMeiaianeDeseribeCoverageRcq+OperationsMctadata:sGetCapabilities操作包含请求信息与响应内容两方面。a)请求：请求关于描述该服务的元数据信息，包括服务的基本信息、服务支持的操作信息和服务支持的数据集元数据信息。具体请求参数描述见表11。9参数名数据类型取值范围字符串字符串名为GetCapabilities字符串一组服务版本号代号。的版本号字符串adata,Contents或All或服务器不支持则返回完整的文档字符串返回响应文档类型的b)响应：返回一个描述服务能力的文档。根据请求参数Sections容(Serviceldentification,ServiceProvider,OperationsMeta构成服务能力描述文档。各部分内容见表12。的定义，选取并组合四项描述内和Contents)中的一项或多项，表12GetCapabilities响应文档ServiceMetadata中各部分描述参数名实现OWS规范的服务在这一部分内容和结构是一致的网站服务者的信息等。所有实现OWS规范的服务在这一部分内容和结构是一致的服务所有实现的操作的元数据信息，包括操作请求的URL地址、服务数据、操作参数的有效值域等。所有实现OWS规范的服务在这一部分内容由具体实现的服务定义描述服务提供的数据的元数据信息。不同的实现OWS规范的服务在这一部分内容和结构DescribeCoverage操作包含请求信息与响应内容两方面。a)请求：请求指定编号的Coverage数据的描述信息。貝体请求参数描述见表13。参数名数据类型取值范围字符串字符串字符串的Coverage的唯一标字符串组整数序列b)响应：返回由Coverageld参数指定的相应Coverage的描述信息文档。文档中单个Coverage描述信息的参数描述见表14。表14Coverage描述信息参数参数名数据类型取值范围整型Coverage覆盖范围Coverage值域结构的GML相关信息见GB/T23708。GetCoverage操作包含请求信息与响应内容两方面。a)请求：请求指定编号的Coverage数据。具体请求参数描述见表15。表15GetCoverage操作请求参数参数名数据类型取值范围字符串字符串字符串b)响应：返回由Coverageld参数指定的Coverage数据。5.2.4WMTS服务接口5.2.4.1接口函数WMTS服务接口函数见表16。表16WMTS服务接口函数函数名获取服务实现规范描述自身能力的元数据文档信息以预定义的数据格式获取特定矩阵集中指定的地图瓦片数据信息WMTS服务接口UML类图见图3。+Requst:string=GiatCapatAcceptformats:string=textxml-Requsst:string=GdFea网络通用服务接口Reyws:GeCupubilriesRegest):ServiceMetalau+OperationsMetadata:s-GeflefinReqest:GefGerleatwrelnforinRequest:GetleuturelnfoRequesr)WMTS服务接口图3WMTS服务接口UML类图GetCapabilities操作包含请求信息与响应内容两方面。a)请求：请求关于描述该服务的元数据信息，包括服务的基本信息、服务支持的操作信息和服务支持的数据集元数据信息。具体请求参数描述见表17。表17GetCapabilities操作请求参数描述参数名数据类型取值范围字符串字符串名为GetCapabilities字符串一组服务版本号代号。的版本号字符串Metadata,Contents或All或服务器不支持则返回完整的文档字符串返回响应文档类型的b)响应：返回一个描述服务能力的文档。根据请求参数Sections的定义，选取并组合四项描述内容(Serviceldentification,ServiceProvider,OperationsMetadata和Contents)中的一项或多项，构成服务能力描述文档。各部分内容见表18。表18GetCapabilities响应文档ServiceMetadata中各部分描述参数名实现OWS规范的服务在这一部分内容和结构是一致的网站服务者的信息等。所有实现OWS规范的服务在这一部分内容和结构是一致的服务所有实现的操作的元数据信息，包括操作请求的URL地址、服务数据、操作参数的有效值域等。所有实现OWS规范的服务在这一部分内容由具体实现的服务定义描述服务提供的数据的元数据信息。不同的实现OWS规范的服务在这一部分内容和结构GetTile操作包含请求信息与响应内容两方面。a)请求：请求指定数据内容及表达形式的地图瓦片数据。具体请求参数描述见表19。表19GetTile操作请求参数描述参数名数据类型取值范围字符串字符串请求图层的唯一标字符串字符串字符串字符串字符串要获取的瓦片矩阵的行号界于0至Tile的总行数之间要获取的瓦片矩阵的列号界于0至Tile的总列数之间b)响应：返回指定位置的地图瓦片数据。GetFeaturelnfo操作包含请求信息与响应内容两方面。a)请求：请求指定位置的地理要素的描述信息。具体请求参数描述见表20。参数名数据类型取值范围字符串字符串字符串J特定瓦片中指定的行索引I特定瓦片中指定的列索引表20(续)参数名数据类型取值范围字符串字符串字符串字符串字符串字符串界于0至Tile的总行数之间界于0至Tile的总列数之间b)响应：以参数InfoFormat指定的格式，返回符合条件的地理要素属性信息。5.3数据操作服务接口WPS服务接口函数见表21。表21WPS服务接口函数函数名获取服务实现规范描述自身能力的元数据文档信息获取运行在该服务实例上的操作的详细信息WPS服务接口UML类图见图4。-OpcrstionsVfctadataAweptFamats:string=texWPS服务接口ltegnes:escribelrvexsReynes):Dseribelrocess-ecuefnReguest:FrrceRequest:ExecweReyonse+Rcqucst:string=DescribeProccssIPocess:ProcessBriefProccssOutputs:ProccssOu网络通用服务接口GietCopcbiiesfinReqaest:Giercablieskegpest):Seniceeladau-Requcst:string=GarCapab+Idcntitier:ows:CoaltIdentfier:ows:CodDeserihe/rvusyin图4WPS服务接口UML类图GetCapabilities该操作包含请求信息与响应内容两方面。a)请求：请求关于描述该服务的元数据信息，包括服务的基本信息、服务支持的操作信息和服务支持的数据集元数据信息。具体请求参数描述见表22。表22GetCapabilities操作请求参数描述参数名数据类型取值范围字符串字符串名为GetCapabilities字符串一组服务版本号代号。字符串Metadata,Contents或All的文档字符串返回响应文档类型的b)响应：返回一个描述服务能力的文档。根据请求参数Sections的定义，选取并组合四项描述内容(Serviceldentification,ServiceProvider,OperationsMetadata和Contents)中的一项或多项，构成服务能力描述文档。各部分内容见表23。表23GetCapabilities响应文档ServiceMetadata中各部分描述参数名实现OWS规范的服务在这一部分内容和结构是一致的网站服务者的信息等。所有实现OWS规范的服务在这一部分内容和结构是一致的服务所有实现的操作的元数据信息，包括操作请求的IRL地址、服务数据、操作参数的有效值域等。所有实现OWS规范的服务在这一部分内容由具体实现的服务定义描述服务提供的数据的元数据信息。不同的实现OWS规范的服务在这一部分内容和结构DescribeProcess操作包含请求信息与响应内容两方面。a)请求：请求某一操作的描述信息。具体请求参数描述见表24。表24DescribeProcess操作请求参数描述参数名取值范围字符串字符串字符串字符串b)响应：返回描述指定操作过程的详细描述文档。文档中的描述信息应包含的参数信息见表25。表25操作描述信息的参数描述参数名数据类型取值范围具体服务支持的操作字符串字符串的输出参数列表指定输出类型结构(见表26)表26输出数据描述类型结构描述参数名数据类型取值范围字符串字符串‘见GB/T197102005条6.3.2.2“MD_标识类”定义。参数名数据类型取值范围字符串字符串字符串由每个实现规范指定请求的操作过程的具体服务支持的操作一系列InputType数据结构(见表28)无输入参数⁶。需要输入参数：至少包定义响应的类型sponseDocument数据(见表29)无输出结果“。有输出结果：描述文档Document与RawDataOutput类型结果任选一种若所请求的操作已绑定了相应的数据，则不需要指定输入参数。输出结果不是数据或都无输出结果。表28InputType数据结构参数名数据类型取值范围字符串数据结构(见表31)符合条件的数据型putReference或DataType数据类型任选一种数据表29RawDataOutput数据结构参数名数据类型取值范围字符申表30Reference数据结构参数名数据类型取值范围指向网络可访问的资字符串字符串表31DataType数据结构参数名数据类型取值范围输入或输出值为复杂数据结构复杂数据结构(见表32)输入或输出结果为字符串两种类型有且只能选择一种数据类型。表32ComplexData数据结构参数名数据类型取值范围字符串b)响应：返回相应操作过程的执行结果文档。文档中的描述信息应包含的参数信息见表33。表33Execute操作返回参数描述参数名数据类型取值范围字符串字符串由具体实现规范指定请求的服务实例结构(见表34)(见表35)据结构(见表36)可选参数。当且仅当表34ProcessBrief数据结构参数名数据类型取值范围字符串字符串表35Status数据结构参数名数据类型取值范围操作完成的时间日期时间型任意日期或时间必选参数。如果操作档的创建时间字符串表35(续)参数名数据类型取值范围并已开始字符串字符串字符串标示操作过程执行结构(见表37)五种元素存在且只存在一种元素。表36ProcessOutputs数据结构参数名数据类型取值范围字符串字符串据结构(见表30)含在文档中(见表31)两种元素存在且只存在一种元素。表37ProcessFailed数据结构参数名数据类型取值范围包含操作执行错误信息字符串数据分析服务接口函数见表38。表38数据分析服务接口函数函数名获取服务实现规范描述自身能力的元数据文档信息获取运行在该服务实例上的操作的详细信息数据分析服务接口UML类图见图5。+Requet:string-GidCapahilAcceptformatsstring=teGenapohiliniesfinBeyuesr:Giaepwahlihiseapses+Requcst:string-DascribePrEecue/uteqiest:Ecuekeqwes):rcdekesponseProessOutpuls:ProccsOuRequest:string=SearchF+Request:string-QuerytFe+Requcst:string=GaElev数据分析服务接口SearchFecnsrerinReguest:ExecadteReguesl:GAfl.-QueryFeaturefinRequest:QaeryFearnreRegaest)CiaEleutuwfimRegnest:GialenufiunReney):GiefElewatiCaRoesfinRegney:Ewcntefecpiesl:GetRarlesResporCeFeutsratnfaReuentRequet:string=GetFeatur图5数据分析服务接口UML类图a)请求：请求关于描述该服务的元数据信息，包括服务的基本信息、服务支持的操作信息和服务支持的数据集元数据信息。具体请求参数描述见表39。参数名数据类型取值范围字符串字符串名为GetCapabilities字符串一组服务版本号代号。可选参数。当请求中省略或服务器不支持则字符串Metadata,Contents或All可选参数。当请求中省略或服务器不支持则返回完整的文档字符串返回响应文档类型的可选参数。当请求中省略或服务器不支持则b)响应：返回一个描述服务能力的文档。根据请求参数Sections的定义，选取并组合四项描述内容(Serviceldentification,ServiceProvider,OperationsMetadata和Contents)中的一项或多项，构成服务能力描述文档。各部分内容见表40。表40GetCapabilities响应文档ServiceM参数名实现OWS规范的服务在这一部分内容和结构是一致的网站服务者的信息等。所有实现OWS规范的服务在这一部分内容和结构是一致的服务所有实现的操作的元数据信息，包括操作请求的URL地址、服务数据、操作参数的有效值域等。所有实现OWS规范的服务在这一部分内容由具体实现的服务定义描述服务提供的数据的元数据信息。不同的实现OWS规范的服务在这一部分内容和结构DescribeProcess操作包含请求信息与响应内容两方面。a)请求：请求某一操作的描述信息。具体请求参数描述见表41。参数名数据类型取值范围字符串字符申字符串名为DescribeProcess字符串b)响应：返回描述指定操作过程的详细描述义档。文档中的描述信息应包含的参数信息见表42。表42操作描述信息的参数描述参数名数据类型取值范围具体服务支持的操作字符串字符串的输出参数列表指定输出类型结构(见表43)参数名数据类型取值范围字符串字符串表44Execute操作请求参数描述参数名数据类型取值范围字符串取值为WPS字符串字符串由每个实现规范指定的标识一系列InputType数据结构(见表45)无输入参数°。的值定义响应的类型表43)。Output数据结构(见表46)无输出结果°。果，则ResponseDocument与RawDataOutput类型结果任选一种若所请求的操作已绑定了相应的数据，则不需要指定输入参数。输出结果不是数据或都无输出结果。表45InputType数据结构参数名数据类型取值范围字符串tRelerence数据结构(见表47)。据结构(见表48)[erence或DataType数表46RawDataOutput数据类型参数名数据类型取值范围字符串表47Reference数据结构参数名数据类型取值范围字符串字符串表48DataType数据结构参数名数据类型取值范围复杂数据结构(见表49)可选参数“字符串两种类型有且只能选择一种数据类型。表49ComplexData数据结构参数名数据类型取值范围字符串b)响应：返回相应操作过程的执行结果文档。文档中的描述信息应包含的参数信息见表50。表50Execute操作返回参数描述参数名数据类型取值范围字符串字符串由具体实现规范指定请求的服务实例据结构(见表51)(见表52)数据结构(见表53)仅当Status值为有输出值参数名数据类型取值范围字符串字符串表52Status数据结构参数名数据类型取值范围操作完成的时间日期时间型日期或时间作未完成，该值为返回文档的创建时间字符串可选参数“并已开始字符串可选参数“字符串字符串(见表54)可选参数“五种元素存在且只存在一种元素。表53ProcessOutputs数据结构参数名数据类型取值范围字符串字符串数据结构(见表47)可选参数”含在文档中构(见表48)两种元素存在且只存在一种元素。表54ProcessFailed数据结构参数名数据类型取值范围包含操作执行错误信息字符串GetFeaturelnfo操作包含请求信息与响应内容两方面。a)请求：请求指定位置的地理要素的描述信息。具体请求参数描述见表55。参数名数据类型取值范围字符申字符申字符串J索引I特定瓦片中指定的列索引字符串字符串字符串字符串字符串字符串要获取的瓦片矩阵的行号界于0至Tile的总行数之间要获取的瓦片矩阵的列号界于0至Tile的总列数之间b)响应：以参数InfoFormat指定的格式，返回符合条件的地理要素属性信息。SearchFeature操作包含请求信息与响应内容两方面。a)请求：请求查找某一位置特定范围内的地理要素。具体请求参数描述见表56。表56SearchFeature操作请求参数描述参数名数据类型取值范围字符串字符串字符串参数名数据类型取值范围查找位置的坐标信息字符申(x,y)或(x,y,z)b)响应：返回以GML格式表达的地理要素的详细描述。QueryFeature操作包含请求信息与响应内容两方面。a)请求：请求查询符合条件的地理要素。具体请求参数描述见表57。表57QueryFeature操作请求参数描述参数名数据类型取值范围字符申字符串字符串字符申b)响应：返回以