GB/T40525-2021
地理信息在线共享接口规范
Specificationofonlinesharinginterfaceforgeographicinformation
- 中国标准分类号（CCS）A75
- 国际标准分类号（ICS）07.040
- 实施日期2021-10-11
- 文件格式PDF
- 文本页数34页
- 文件大小2.52M
以图片形式预览地理信息在线共享接口规范
地理信息在线共享接口规范
国家标准 GB/T40525一2021 地理信息在线共享接口规范 Speeifieationofomlnesharinginterfaeeforgeographieinformation 2021-10-11发布 2021-10-11实施 国家市场监督管理总局 发布 国家标涯花管理委员会国家标准
GB/T40525一2021 次 目 前言 范围 2 规范性引用文件 3 术语和定义 缩略语 基本服务接口 5.1分类 5.2数据目录服务接口 15 5.3数据操作服务接口 6 ++ 21 扩展服务要求 附录A(资料性附录)开放查询服务XML模式 22 附录B资料性附录服务接口用例 28 参考文献 31
GB/40525一2021 前 言 本标准按照GB/T1.1一2009给出的规则起草
本标准由自然资源部提出
本标准由全国地理信息标准化技术委员会(SAC/TC230)归口
本标准起草单位:武汉大学、北京中科数遥信息技术有限公司、福州大学、北京吉威时代软件股份有 限公司、武大吉奥信息技术有限公司、北京建筑大学,清华大学、国家基础地理信息中心陕西省煤田物 探测绘有限公司
本标准主要起草人:邵远征、龚健雅、李霖、朱海红、戴雪峰、毕建涛、余劲松弟、黎坷、何友、谭成国、 王国良、蒋捷、白玉琪,金梦、杜晓、张秋义、康荔
GB/T40525一2021 地理信息在线共享接口规范 范围 本标准规定了地理信息数据在线共享的基本服务接口和扩展服务要求
本标准适用于地理信息数据资源在线服务平台的建设与应用
规范性引用文件 下列文件对于本文件的应用是必不可少的
凡是注日期的引用文件,仅注日期的版本适用于本文 凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件
件
GB/T7408一2005数据元和交换格式信息交换日期和时间表示法 GB/T19710一2005地理信息元数据 GB/T23708一2009地理信息地理标记语言(GML) GB/T25597一2010地理信息万维网地图服务接口 GB/T30169一2013地理信息基于网络的要素服务 术语和定义 下列术语和定义适用于本文件
3.1 地理信息gegraphiealimfomatonm 与地球上的地点直接或间接相关的现象的信息
[GB/T17694一2009,定义B.211] 3.2 phicalinformationservice 地理信息服务gegrap 向用户提供转换、管理或表示地理信息(3.1)的服务
[GB/T17694一2009,定义B.212] 3.3 基本服务fundamentalservice 面向地理信息(3.1)数据的在线共享,提供的基于标准接口的目录服务,发布服务及操作服务
3,4 扩展服务extendedserviee 基本服务(3.3)无法满足共享需求时,自定义的其他服务接口
缩略语 CSW 网络目录服务(CatalogueServicefortheweb) GML 地理标记语言(GeographyMarkupLanguage) HTTP 超文本传输协议(HypertextTransferProtocol)
GB/T40525一202 KVP 键值对(KeywordValuePair MIME 多用途互联网邮件扩展(MultipurposeInternetMailExtensions) OGC tialConsortium 开放地理空间信息联盟(OpenGeopat OSDD 开放查询描述文档(O )penSearchDescriptionD0ocument ows 网络服务通用规范(OGCwebServicesCommonStandard) RCe 征求意见(Ree eguestforComments 简易信息聚合(ReallySimpleSyndieation) 统一资源定位符(UniformResourceLocator) 统一建模语言(UnifiedModelingLanguage) erageService 网络覆盖服务(webCover 网络要素服务(webFeatureServiee) wNs 网络地图服务(WebMapService wMTs 网络地图瓦片服务(webMapTileService WPS 网络处理服务(WebProcessingService) XM 可扩展标记语言(ExtensibleMarkupIanguage 基本服务接口 5 5.1分类 本标准定义的地理信息在线共享服务涵盖数据目录服务、数据发布服务和数据操作服务,具体 如下 数据目录服务;包含开放查询服务(OpenSearch)、网络目录服务(cSw); 1 数据发布服务;包含网络地图服务(wMs)、网络要素服务(wFS)、网络覆盖服务(wCs)及网 络地图瓦片服务(wMTs): 数据操作服务;包含网络处理服务(wPs) 3 5.2数据目录服务接口 5.2.1openseareh服务接口 5.2.1.1描述文档 开放查询服务(OpenSeareh)是基于特定的网络查询接口实现查询结果的聚合,需提供开放查询描 述文档,用以描述开放查询服务的元数据和基于XML的查询模板
一个完整的开放查询描述文档包 含必要性元素和可选性元素
描述文档中必要性元素的父节点是(OpenSearchDeseription)元素,其具体说明见表1
表1开放查询描述文档必要性元素 元素名 描述 备注 OpenSearchDescripton)是osDD文档的 在osDD文档中有且仅出现一次 OpenSearchDeseription 根节点 用简要文本来标识openSeareh服务器的该元素最多包含16个字符,且不包含HTMn ShortName 名称信息 或者其他标记语言
GB/T40525一2021 表1(续 元素名 描述 备注 指明关于OpenSearch服务器的可读详细该元素最多包含1024个字符，且不包含 Deseription 信息 HTM或者其他标记语言 描述客户构建OpenSearch查询时应遵循 URL 其包含的属性信息见表2 的规则和参数的描述 给出OpenSearch服务器可以执行的查询在OSDD文档中可出现1次或者多次,其包含 Query 请求 的属性信息见表3 表2URL)元素的属性信息 属性名 描述 数据类型 备注 指定构建 OpenSeareh 查询请求时的URL
前缀和支持的 字符串 必选属性 template 参数 描述数据资源所采用的MME类型,即openSeareh查询明 字符串 必选属性 type 应文档的MIME类型" 指定第一个查询结果的索引号 index(Offset 正整数 可选属性 缺省值为“T 指定第一个查询结果的分页号 pageOffset 正整数 可选属性 缺省值为“1” 本标准规定查询响应文档的MIME类型包括AToM和Rss,其对应的MME如下 RSS;applieation/rss十xml -Xml
AToMaliatiom/atom+ 表3(Query)元素的属性信息 属性名 描述 数据类型 备注 role 指明查询模板中请求的类型,“role=example”应显式指定 字符串 必选属性 指明查询模板中数据类型标识符,不包含HTML或者其他 dataset_id 字符串 必选属性 标记语言 title 查询模板中请求的可读性描述 字符串 可选属性 查询模板中返回第一个结果的索引位置 startlndex 正整数 可选属性 查询模板中返回结果的数目 正整数 可选属性 count 查询指定的空间范围,顺序为“最小经度,最小纬度,最大经 可选属性 字符串 box 度,最大纬度” 查询指定的起始时间,遵循GB/T7408一2005的规定 字符型 可选属性 star 查询指定的终止时间,遵循GB/T74082005的规定 字符串 可选属性 end
GB/T40525一2021 描述文档中可选性元素的父节点是(Openl sartDesripion)元素,其说明见表1 表4开放查询描述文档可选性元素 元素名 描述 备注 用扩展的可读文本来标识OpenS Seareh服务最多包含48个字符,且不包含HML或者其 LongName 器的名称信息 他标记语言
可出现0次或者1次 用来标识Openseareh服务器维护人的有效 Contact 可出现0次或者1次 电子邮件地址信息 用一组关键字对数据中心查询内容进行标最多包含256个字符,多个标签之间用一个空 Tags 识和分类 格符号分割
可出现0次或者1次 lmage 包含一个与查询内容相关联图片的URL 可出现0次、l次或者多次,其属性见表5 用可读文本来标识osDD文档创建者或维该元素最多包含64个字符.且不包含HTML Developer 护者信息 或者其他标记语言
可出现0次或者1次 最多包含256个字符,且不包含HML或者 Attribution 用可读文本来标识数据中心的版权信息 其他标记语言
可出现0次或者1次 用字符串来标识OpenSearch服务器支持的最多包含256个字符,且不包含HTML
或者 Language 语言 其他标记语言
可出现0次、l次或者多次 用字符串来标识OpenSeareh服务器支持查 lnputEncoding 可出现0次、1次或者多次 询请求的编码,缺省值是"UTF-8” 用字符串来标识OpensSeareh服务器支持t OutputEncoding 可出现0次、1次或者多次 询响应的编码,缺省值是“UTF-8” 表5Image)元素的属性信息 属性名 必选/可选 数据类型 说明 height 可选 正整数 引用图片高度的像素数 正整数 引用图片宽度的像素数 width 可选 可选 MIME 引用图片的MIME类型 type 5.2.1.2查询请求 开放查询服务的请求参数见表6
表6openSearch支持查询参数 参数名 描述 数据类型 取值范围 备注 OSDD文档中(Query)元素指定 Dataset_id 说明产品类型的标识符 字符串 必选参数 的dataset_id属性" 指定返回查询结果的XML聚 Format 字符型 缺省值为“atom"” 可选参数 合格式
GB/T40525一2021 表6(续 数据类型 参数名 描述 取值范围 备注 返回查询结果的起始记录索 StartRecord 正整数 缺省值为“1” 可选参数 引值 MaximumRecords 每次返回查询结果的记录数 正整数 缺省值为“10” 可选参数 指定查询的起始时间 可选参数 StartDate 字符串 满足GB/T7408一2005的要求" EndDate 指定查询的截至时间 可选参数 字符串 查询指定的空间范围 缺省值是全球范围,即“一180.0. Bbox 顺序为“最小经度,最小纬度，字符串 可选参数 -90.0,l80.0,90.0” 最大经度,最大纬度" 每次查询用户仅能指定一个合法的产品标识符dataseLid. 如不指定,服务器执行后台查询时应忽略起始及截至时间参数 5.2.1.3查询响应 对有效的OpenSearch请求的响应是查询参数指定的XMI聚合格式
无效的OpenSearch请求应 产生一个异常信息(或在极端情况下响应一个网络协议错误)
在HTTP环境下,返回值的Co ontent type实体头的类型应和返回值格式相匹配
开放查询的响应XM1模式参见附录A中的A.1,服务异常响应的XML模式参见A.2
sw服务接口 5.2.2 5.2.2.1 接口函数 数据目录服务接口函数见表7
表7数据目录服务接口函数 丽数名 功能描述 备注 获取服务实现规范描述自身能力的元数据元数据文档中包含描述服务性能的元数据信 GetCapabilities 息以及该服务支持哪些操作和哪些数据集等 文档 DescribeRecord 返回对目录条目类型及内容的说明信息 该操作用于搜索目录内容,返回所有满足条 GetReeords 件的结果 提供对目录信息的搜索、发现功能 GetRecordbyld 通过标识符返回注册对象 GetDomainm 返回指定类型的取值范围 以推送的方式,允许客户对目录内容进行插 Transaction ,删除及更新的操作 提供对目录注册对象的管理功能 以拉取的方式提供对远程资源的获取及目 Harvest 录注册服务 数据目录服务CSW接口用例参见附录B中的B.1
GB/T40525一2021 5.2.2.2UML类图 数据目录服务接口UM类图如图1所示
GetCapabilitiesRequest SeieNletadata Seioe:sring=OWS interce +Senvieldenificaion;string 网络通用服务接口 Reu:string=GCnabilities +ServiceProvider:string vs strime Opemtins\Metadhta;sring +GerCuhiliia/inReg:GeCguhiiRege):eiceeakiaa C1Os string Contants:string +AcceptFormats:string-text/Nml interce 数据目录服务接口 DieRRe CmRuse DaRm健DaheRwReM CSw Seiee:smg-CSW SecnVice:string GiRenknRgae;GiuRerkRee/ Requst:strin吗=GatDoma Requst:string=DsaibeRecord GRewnRegN:t Re:GieRenhR城" Vasin:string asion:string GeDin(im /mMgk:s:GaDoinRs PaamcterName:string +TypxeNane:string-text/xml rmNinReg:7rkcink +PropetyName:string aesmRke:HaureRncsl TranstionReuest HastReguKst GetReeorbyldRequest GetRecordsRuest Seviae;string-CSW Senviae:string Seniee:string-CSw tSeniee:strig Rcauat sme Tansaction +Reaust:string=Harvest -Regust sme -GcRacordbyld -Reaust ;smeg GRacord Gsion eTsion sion rvarsion:srimg :strng str1n吗 strin吗g y lnscrt:string Soucc:strin吗 TycNmG:string Upxtate:string +Res0uceypc:string EkemantSetNamc:string Dcetestrin吗 manName:strin吗g Constaint:string 图1数据目录服务接口类图 5.2.2.3GeCapabilities操作 GetCapabilitties操作包含请求信息与响应内容两方面 请求;请求关于描述该服务元数据信息,包括服务的基本信息、服务支持的操作信息和服务支 a 持的数据集元数据信息
具体请求参数描述见表8
表8GeCapabilities操作请求参数描述表 数据类型 取值范围 参数名 描述 备注 服务名缩写,此服务取值 服务类型标识符 字符串 必选参数 Service 为CSW 请求的操作名称,操作名 Request 请求的操作名称 字符串 必选参数 为GetCapabilities 可选参数
如1.1.0,当请求 AcceptVersions 请求的版本号 -组服务版本号代号 字符串 中省略或服务器不支持则 返回最新版本号 文档描述部分的名称
Servieeldentification 可选参数
当请求中省略 确定返回文档中只包 或服务器不支持则返回完 字符串 ServieeProvider, Sectins 含所请求的描述部分 (OperationsMetadata. 整的文档 Contents或All 按照先后顺序,请求希 可选参数
当请求中省略 返回响应文档类型的标 AcceptFormats 望返回的可接受的字符串 或服务器不支持则返回 识符 MIME类型列表 “text/xml nml"格式文档
GB/T40525一2021 b)响应;返回一个描述服务能力的文档
根据请求参数Sections的定义,选取并组合四项描述内 容(Serviceldentifieation,ServieeProvider,OperationsMetadata和Contents)中的一项或多项 构成服务能力描述文档
各部分内容见表9
表9GetCapabilities响应文档ServiceMetadata中各部分描述 参数名 描述 关于服务的描述信息,包括服务的基本信息,如服务类型,服务名、服务简单描述等
所有实 Serviceldentification 现OwS规范的服务在这一部分内容和结构是一致的 服务提供者的基本信息,包括服务提供者的唯一标识符,与服务提供者相关联的网站、网站服 vieeProvider Ser 务者的联系信息等
所有实现OwS规范的服务在这一部分内容和结构是一致的 服务所有实现的操作的元数据信息包括操作请求的URL.地址,服务接口实现的操作的元数 OperationsMetadata 据,操作参数的有效值域等
所有实现OwS规范的服务在这一部分基本结构是一致的,但内 容由具体实现的服务定义 描述服务提供的数据的元数据信息
不同的实现OWS规范的服务在这一部分内容和结构是 Contents 不同的,由具体实现的服务定义 5.2.2.4DeserieReeorl操作 DeseribeRecord操作包含请求信息与响应内容两方面 请求;请求指定名称的已注册服务的类型、内容等详细描述信息
具体请求参数描述见表10. 表10DescribeReord操作请求参数描述表 参数名 描述 数据类型 取值范围 备注 服务名缩写,此服务取值 服务类型标识符 字符串 必选参数 Service 为CSw 请求的操作名称,操作名 请求的操作名称 字符串 必选参数 Request 为DesceribeRecord Version 请求的版本号 字符串 请求的服务版本号 必选参数 请求的已注册记录 可选参数
默认值为返回所 TypeName 字符串 任意字符 的名称 有存在的已注册记录 b 响应;返回已注册服务相关内容的详细描述文档
5.2.2.5GelReords操作 GetRecords操作包含请求信息与响应内容两方面: 请求;请求所有满足条件的已注册服务
具体请求参数描述见表11
a 表11GetRecordls操作请求参数描述表 参数名 描述 数据类型 取值范 备注 服务名缩写,此服务取值 字符串 Service 服务类型标识符 必选参数 为CSw 请求的操作名称,操作名" 字符串 请求的操作名称 Reguest 必选参数 为GetRecords
GB/T40525一2021 表11(续 参数名 描述 数据类型 取值范围 备注 请求的服务版本号 必选参数 Version 请求的版本号 字符串 目录服务信息查询实体 字符串 任意字符 必选参数 TypeNames -个或多个名字列表 ElementSet brief,summary或ful" 必选参数 设置显示记录集的方式 字符串 Name 指定元数据中记录元素 字符串 可选参数 ElementName 任意字符 可选参数
默认值为不 Constraint 指定查询条件 字符串 任意字符 限制条件查询 记录集的显示方式被预先定义为;bnief,summary,fl,用以展示返回记录描述的细节层次
其中brie代表最 少的细节描述,而foll代表返回记录包含其存档时的所有元数据项描述
关于brief.sumary及ful具体包含 的元数据项,须根据不同的数据类型,通过扩展的方式加以明确限定
b 响应:返回描述符合条件的已注册服务的文档
5.2.2.6GetRecordbyld操作 GetRecordbyld操作包含请求信息与响应内容两方面 请求;根据注册对象的ID号请求满足条件的已注册服务
具体请求参数描述见表12
a 表12Geteeordyd操作请求参数描述表 参数名 描述 数据类型 取值范围 备注 Service 服务类型标识符 字符串 服务名缩写,此服务取值为CSw必选参数 请求的操作名称,操作名为Ge Request 请求的操作名称 字符串 必选参数 tRecordbyld 请求的服务版本号 必选参数 Version 请求的版本号 字符串 逗号分隔的UR1列表表示要查 字符串 必选参数 d 任意字符 询的ld b 响应;返回描述符合条件的已注册服务的文档
5.2.2.7 GetDomain 操作 GetDomain操作包含请求信息与响应内容两方面 请求;请求某一参数或属性的值域范围
具体请求参数描述见表13
a 表13GetDomain操作请求参数描述表 参数名 描述 数据类型 取值范围 备注 服务类型标识符 字符串 服务名缩写,此服务取值为CSw 必选参数 SerVice 请求的操作名称 字符串 请求的操作名称,操作名为GetDomain 必选参数 Regquest Versionm 字符串 请求的版本号 请求的服务版本号 必选参数 ParameterName请求的接口参数名 字符串 接口函数中参数名称集 PatameterName、Prop eryName二者选其 PropertyName 请求的属性名 字符串 属性名称集
GB/T40525一2021 b 响应;返回描述指定接口参数或属性的值域范围的文档
5.2.2.8Transaction操作 Transaction操作包含请求信息与响应内容两方面 请求;请求注册远程服务资源
以推送的方式,允许客户对目录内容进行插人,删除及更新的 a 操作
Transaction操作不支持KVP编码请求,应使用HTTPPOST方法通过XML传输参 数
具体请求参数描述见表14
表14Iransaction操作请求参数描述表 参数名 描述 数据类型 取值范围 备注 服务类型标识符 字符串 服务名缩写,此服务取值为cSw 必选参数 Service Reguest 字符串 请求的操作名称,操作名为Transaction 必选参数 请求的操作名称 Version 请求的版本号 字符串 请求的服务版本号 必选参数 nsert 添加注册信息 字符串 任意字符 Insert、Update、Delete 三个参数至少选择其 Update 修改注册信息 字符串 任意字符 中一项,也可全选 删除注册信息 字符串 任意字符 Delete b 响应;根据请求参数返回描述操作反馈信息的文档
5.2.2.9Harvest操作 Harvest操作包含请求信息与响应内容两方面: 请求;请求注册远程服务资源,以拉取的方式获取远程服务资源,并在目录中注册
具体请求 参数描述见表15
表15Harvest操作请求参数描述表 数据类型 取值范围 参数名 描述 备注 服务类型标识符 字符中 服务名缩写,此服务取值为csw 必选参数 Service 字符串 必选参数 Reguest 请求的操作名称 请求的操作名称,操作名为Hat arvest Version 请求的版本号 字符串 请求的服务版本号 必选参数 Source 引用的元数据源位置 字符串 任意字符 必选参数 b 响应;返回描述操作反馈信息的文档
数据发布服务接口
5.2.3wMS服务接口 wMS服务接口规范应按照GB/T255972010执行
5.2.4wFS服务接口 WFS服务接口规范应按照G;B/T30169一2013执行
5.2.5wCS服务接口 5.2.5.1接口函数 wCS服务接口函数见表16
GB/T40525一2021 表16wCS服务接口函数 丽数名 功能描述 备注 获取服务实现规范描述自身能力的元数据元数据文档中包含描述服务功能的元数据信息 GetCapabilities 文档 以及该服务支持哪些操作和哪些数据集等 Describe(Coverage 获取一个或多个Coverage数据的详细描述 多个Coverage的标识符以逗号分开 以特定的格式获取所需的coverag数据 可指定返回数据的格式、投影以及空间范围等 GetCoverage wCS服务接口用例参见B.2
5.2.5.2UML类图 wCS服务接口UML类图如图2所示
GCGRe SenviceNletdatn 1Senirig-WCS SenViceldertificaticn:ring +Reouo:ring-GtCpbiltes 网格用服务接口 SenviaePowidersrin AacepVesios:ring Opeationsketadata:sring GCamKEGCNEaa string Contats:string Asmeneesm C3C wS服务擦口 DscricCoerageRcquest 十DscnheCoere(imReqes/:DscribeCoeraeReges:DsoribeCoere nroeResypwse DsccribeCoverageRsponse +SeriGe WCS GConeuuNRes:GCouewes 二STT三 HCoenIEd;unt +Reaucst:sring-DsribeCouge +RargeTe:虹rin GetCoermeRequest srn-WCS eViCe Reauet:string-GCoverage Coweaeldint 图2wCs服务接口类图 5.2.5.3GetCapabhilities操作 wCS服务的GetCapabilities操作包含请求信息与响应内容两方面 a 请求;请求关于描述该服务元数据信息,包括服务的基本信息、服务支持的操作信息和服务支 持的数据集元数据信息
具体请求参数措述见表17
表17wCS服务GetCapabilities操作请求参数描述表 参数名 描述 数据类型 取值范围 备注 必选参数 字符串 服务类型标识符 服务名缩写,此服务取值为wcs Service 请求的操作名称,操作名为GetCa- Request 请求的操作名称 字符串 必选参数 pabilities 可选参数
当请求中省 -组服务版本号代号
如1.1.0的 AcceptVersions 请求的版本号 字符串 略或服务器不支持则返 形式 回最新的版本号 确定返回文档中只 文档描述部分的名称
Servicel-可选参数
当请求中省 包含所请求的擂述字符串 略或服务器不支持则返 Sections dentification，ServiceProvider，Op 部分 erationsMetadata.,Contents或Al 回完整的文档 10
GB/T40525一2021 表17(续 取值范围 参数名 描述 数据类型 备注 按照先后顺序,请求 可选参数
当请求中省 AcceptFormats 希望返回的可接受字符串 返回响应文档类型的标识符 略或服务器不支持则返 回“text/ 的MIME类型列表 xml"格式文档 b 响应;返回一个描述服务能力的文档
根据请求参数Seetions的定义,选取并组合四项描述内 tionsMetadata和Content 容(Serviceldentifieation,ServiceProvider, ts)中的一项或多项 r.Operat 构成服务能力描述文档
各部分内容见表18. 表18GeCapabilities响应文档ServiceMetadata中各部分描述 参数名 描述 关于服务的描述信息,包括服务的基本信息,如服务类型、服务名、服务简单描述等
所有 Servieeldentification 实现owS规范的服务在这一部分内容和结构是一致的 服务提供者的基本信息,包括服务提供者的唯一标识符、与服务提供者的相关联的网站、网 ServieeProvider 站服务者的联系信息等
所有实现ows规范的服务在这一部分内容和结构是一致的 服务所有实现的操作的元数据信息,包括操作请求的URL地址,服务接口实现的操作的元 数据,操作参数的有效值域等
所有实现ows规范的服务在这一部分基本结构是一致的. OperationsMetadata 但内容由具体实现的服务定义 描述服务提供的数据的元数据信息
不同的实现owS规范的服务在这一部分内容和结构 Contents 是不同的,由具体实现的服务定义 5.2.5.4 DescribeCoverage操作 wCS服务的DeseribeCoverage操作包含请求信息与响应内容两方面: 请求;请求指定编号的coverage数据的描述信息
具体请求参数描述见表19.
a 表19DescribeCoverage操作请求参数描述表 描述 数据类型 取值范围 参数名 备注 Serviee 服务类型标识符 字符串 服务名缩写,此服务取值为wC'S必选参数 请求的操作名称，操作名为 字符串 必选参数 请求的操作名称 Reguest DescribeCoverage 请求的版本号 Version 字符串 请求的服务版本号 必选参数 个或多个请求描述的Cov 必选参数,以逗号分 字符串 Coverageld 大于0的整数值 ernge的唯一标识 隔的一组整数序列 b 响应;返回由Coverageld参数指定的相应Coverage的描述信息文档
文档中单个Coverage 描述信息的参数描述见表20.
1
GB/T40525一2021 C 表20 Coverage描述信息参数表 参数名 描述 数据类型 取值范围 备注 Coverage明确的唯一标识码 整型 大于0的整数值 必选参数 Coverageld 覆盖范围描述 NL 任意值 必选参数 DomainSet Coverage DomainSet Coverage值域结构的描述 SwECommon:;DataRecordl 必选参数 任意值 RangeType GML.相关信息见GBy/T23708一2009 5.2.5.5GetCoverage 操作 wCS服务的GetCoverage操作包含请求信息与响应内容两方面 a 请求;请求指定编号的Coverage数据
具体请求参数描述见表21
表21GetCoerage操作请求参数表 参数名 描述 数据类型 取值范围 备迷 服务类型标识符 字符中 服务名缩写,此服务取值为wCs 必选参数 Service Request 请求的操作名称 字符串 请求的操作名称,操作名为GetCoverage 必选参数 必选参数 Version 请求的版本号 字符串 请求的服务版本号 Coverageld Coverage数据的唯一标识码 整型 大于0的整数值 必选参数 DescribeCoverage响应中指定的支持格式 字符串 返回数据的格式 可选参数 Format 的MIME类型 响应;返回由Coverageld参数指定的coverage数据
b 5.2.6wMTs服务接口 接口函数 5.2.6.1 wMTs服务接口函数见表22.
表22wMIs服务接口函数 丽数名 功能描述 备注 元数据文档中包含描述服务功能的元数据信 获取服务实现规范描述自身能力的元数据文档 GetCapabilities 息以及该服务支持哪些操作和哪些数据集等 以预定义的数据格式获取特定矩阵集中指定的 GetTile 地图瓦片数据 GetFeaturelnfo 获取在特定瓦片中指定像元的要素谊染信息 5.2.6.2LUM类图 wMTS服务接口UML类图如图3所示
12
GB/T40525一2021 senieeMetaata G;etCapabilitiesRequest +Sevie:string=WMTS Serioeldetification:string
GB/T40525一2021 表26GetFeaturel Info操作请求参数描述表 参数名 描述 数据类型 取值范围 备注 服务类型标识符 字符串 服务名缩写,此服务取值为wMTs 必选参数 Service 请求的操作名称,操作名为GetFeature- 必选参数 Request 请求的操作名称 字符串 Info Versionm 请求的版本号 字符串 请求的服务版本号 必选参数 特定瓦片中指定的行索引 整型 大于0的整数值 必选参数 特定瓦片中指定的列索引 整型 大于0的整数值 必选参数 InfoFormat 输出信息的格式 字符串 服务提供的格式类型 必选参数 Layer 请求图层的唯一标识符 字符串 服务提供的图层列表 必选参数 与请求图层对应的渲染样式 字符串 服务提供的图层对应样式列表 必选参数 Style Format Tile的输出格式 字符串 服务提供的格式类型 必选参数 TleMatriXset 指定的瓦片矩阵集合标识 字符串 服务定义的瓦片矩阵集合标识列表 必选参数 TileMatrix 指定的瓦片矩阵标识 字符串 必选参数 服务定义的瓦片矩阵标识列表 要获取的瓦片矩阵的行号 大于或等于0且小于Tle的总行数 TileRow 整型 必选参数 TileCol 要获取的瓦片矩阵的列号 整型 大于或等于0且小于Tile的总列数 必选参数 响应;以参数InfoFormat指定的格式,返回符合条件的地理要素属性信息 b 5.3数据操作服务接口 5.3.1接口函数 wWPS服务接口函数见表27
表27wPs服务接口函数 丽数名 功能描述 备注 获取服务实现规范描述自身能力的元数据元数据文档中包含描述服务性能的元数据信 GetCapabilities 息以及该服务支持哪些操作和哪些数据集等 文档 包含了可以提供的所有空间分析操作,基于 获取运行在该服务实例上的操作的详细 DescribeProcess DescribeProcess文档的描述信息,客户端根据 信息 实际需求构造 请求 Execute Execute 执行指定的操作过程 数据操作服务wPs接口用例参见B.3
5.3.2UM类图 wPS服务接口UML类图如图4所示
15
GB/T40525一202 SenieeNetdte GetCapabiliiesReest SeieIdiheti;img +Senice:string=WPS ServicePovider ST1t +Reauos:srin=GCpbilhites GCsNECGCsNEnn +Opeationsetadata:string +AaepXVersons:string Cntants:strine AaepxFoxmats:string-tem sinterfce 服务接口 DscrilePres cessRequest DscribePwcess/imReges:DsribePwcessReges):DescribeProessResypIsv DsribeProcessRsponse .xeemReges:.eceRe/:.ecleReNe" Senie:string=WP5 ldentifer:os.CadeTpe Rcpu:string-DsaibePoces VCSO string PoccssVersion;string dentifer cetse 二OS ProcssOpus ExeeueResponse EcuteReest +Seniae:string-WPs 1Scnice:string=WPS +Reus:string=Exeaute HVasiom:string Senielnstance:string nurIye ldkentifier:owws:CoxleType PocosBniet ifher:OomsCeType SaISaS +D道alnputs:lnmputType +Ttle:string sOutxs tDtSPOCeS +RcponscFam lputDita 图4wPs服务接口类图 5.3.3GetCapabilities操作 wPS服务的GetCapabilities该操作包含请求信息与响应内容两方面 请求:请求关于描述该服务元数据信息,包括服务的基本信息、服务支持的操作信息和服务支 a 持的数据集元数据信息
具体请求参数描述见表28
表28ws服务GetCapabilities操作请求参数描述表 参数名 描述 数据类型 取值范围 备注 Service 服务类型标识符 字符串 服务名缩写,此服务取值为WPS必选参数 请求的操作名称,操作名为Get 字符串 Regquest 请求的操作名称 必选参数 Capabilities 可选参数
当请求中省略 组服务版本号代号
如1.1.0 AcceptVer 请求的版本号 字符串 或服务器不支持则返回最 的形式 sions 新的版本号 文档描述部分的名称
seryieel 确定返回文档中只 可选参数
当请求中省略 dentification ServiceProvider， 包含所请求的描述字符串 或服务器不支持则返国完 Seetions OperationsMetadata. Contents 部分 整的文档 或All 按照先后顺序,请求 可选参数
当请求中省略 AcceptFor 返回的MIME类型 字符串 返回响应文档类型的标识符 或服务器不支持则返回 mats 列表 “text/xml"格式文档 响应;返回一个描述服务能力的文档
根据请求参数Seetions的定义,选取并组合四项描述内 b 容(Serviteeldentifieation,.SservieeProider.OperationsMetadata和Contents)中的一项或多项 构成服务能力描述文档
各部分内容见表29
16
GB/T40525一2021 表29GeCapabiliies响应文档ServieeMetadata 中各部分描述 参数名 描述 关于服务的描述信息,包括服务的基本信息,如服务类型,服务名,服务简单描述等
所有实 Servieeldentification 现 ows规范的服务在这一部分内容和结构是一致的 服务提供者的基本信息,包括服务提供者的唯一标识符,与服务提供者的相关联的网站,网站 ServiceProider 服务者的联系信息等
所有实现OWS规范的服务在这一部分内容和结构是一致的 服务所有实现的操作的元数据信息,包括操作请求的URL地址,服务接口实现的操作的元数 据,操作参数的有效值域等
所有实现OwS规范的服务在这一部分基本结构是一致的,但内 OperationsMetadata 容由 现的服务定义 具体实于 描述服务提供的数据的元数据信息
不同的实现owS规范的服务在这一部分内容和结构是 Contents 不同的,由具体实现的服务定义 5.3.4DescribeProeess操作 wpS服务的DerileProess操作包含请求信息与响应内容两方面,本文中的数据类型ows:Co deType具体见GB/T197102005中6.3.2.2“MD_标识类”定义
a 请求;请求某一操作的描述信息
具体请求参数描述见表30. 表30DeserihePreess操作请求参数描述表 参数名 描述 数据类型 取值范围 备注 必选参数 Serviee 服务类型标识符 字符串 服务名缩写,此服务取值为wPS Versionm 请求的版本号 字符串 必选参数 请求的服务版本号 请求的操作名称 字符串 请求的操作名称,操作名为De 必选参数 Reguest DescribeProcess 请求的操作标识 字符串 具体服务支持的处理标识符 必选参数 dentifier b 响应.返回描述指定操作过醒的详细捕述文档
文档中的描述信息应包含的参数信息见表 31,关于输出数据描述类型结构ProcessOutputs的描述见表32
表31处理操作描述信息的参数描述表 描述 取值范围 参数名 数据类型！ 备注 Identifier 操作的标识符或名称 ows:Cod kT 具体服务支持的操作标识符 必选参数 字符串 任意字符 Title 操作的标题 必选参数 操作发布的版本号 任意字符 必选参数 ProeessVersion 字符串 执行操作必备及可选的指定输出类型结构 类型结构 必选参数 Process(Outputs 输出参数列表 见表32 表32输出数据描述类型结构描述表 描述 数据类型 取值范围 参数名 备注 Ca 必选参数 输出结果标识符 ldentiier ows: 任意值 输出结果名称 字符串电 任意字符 Title 必选参数 Abstract 输出结果摘要 字符串 任意字符 可选参数 17
GB/T40525一2021 5.3.5Exeeute操作 wPS服务的Execute操作包含请求信息与响应内容两方面 请求;请求执行所指定的操作过程
具体请求参数描述见表33,其中Datalnputs的数据类型 a 见表34,ResponseForm的数据类型见表35
表33Exeeute操作请求参数描述表 参数名 描述 数据类型 取值范围 备注 服务名缩写,此服务取值 Serviee 服务类型标识符 字符串 必选参数 为wPS 请求的操作名称,操作名 请求的操作名称 字符串 必选参数 Reauest 为 Execute Version 字符串 操作的版本号 由每个实现规范指定 必选参数 具体服务支持的操作标 dentifier 请求的操作过程的标识 ows;CodeType 必选参数 识符 无输人参数" 提供该操作的数据输人 系列lnputType 需要输人参数;至少包含可选参数 Datalnputs 参数列表 类型值(见表34) -个InputType的值 描述文档 可选参数
ResponseDocument 无输出结果" 若有输出结果，则 类型(见表35 ResponseForm 定义响应的类型 有输出结果;描述文档或ResponseDocument 输出数据: 输出数据 与RawData(Output类 RawDataOutput 型结果任选 一种 类型(见表 37 若所请求的操作已绑定了相应的数据,则不需要指定输人参数
输出结果不是数据或都无输出结果
表34InputIype数据结构表 参数名 备注 描述 数据类型 取值范围 ldentifier 参数的标识 ows:CodeType 标识符 必选参数 Title 参数名称 字符串 参数名,如缓冲半径 可选参数 数据引用链接: 条件参数 lnputReference类型(见表42 输人的数据 符合条件的数据型 lnputData InputReference或DataType数 数据值 据类型任选一种数据表达方式 DataType类型(见表43) 18
GB/T40525一2021 表35kespnseDeument 数据类型 取值范围 参数名 描述 数据类型 备注 输出结果文件是否保存 True或者False可选参数 storeExecuteResponse 布尔型 执行操作的结果是否包含数 lineage 据输人Datalnputs和输出定 布尔型 True或者False可选参数 义OutputDefinition元素 定义执行结果输出的格式编 DocumentOutputDefi Output 任意值 可选参数 码和xML模式 类型(见表 nition 36 输出结果编码 URI类型 任意值 可选参数 encoding 表36DeumentOutputDeinition数据类型 参数名 描述 数据类型 取值范围 备浊 ldentifier 输出结果的标识 CaT 必选参数 输出结果的标识符 ows: 输出结果名称 任意字符 必选参数 Title 字符串 Abstract 输出结果摘要 字符串 任意字符 可选参数 mimeType 输出结果的MIME类型 字符串 任意值 可选参数 输出结果编码 任意值 encoding URI类型 可选参数 输出结果保存且作为网络可 asReference 布尔型 True或者False 可选参数 获取的资源 表37RawDataOutpu数据类型 数据类型 取值范围 参数名 描述 备注 ldentifier 输出结果的标识 ows:CodeType 输出结果的标识符 必选参数 输出结果的MIME类型 字符串 任意值 mimeType 可选参数 输出结果编码 URI类型 任意值 可选参数 encoding b 响应;返回相应操作过程的执行结果文档
文档中的描述信息应包含的参数信息见表38
表38Exeeute操作返回参数描述表 数据类型 取值范围 参数名 描述 备注 服务名缩写,此服务取值为 服务类型标识符 字符串 必选参数 SerVIce WPS 字符串 由具体实现规范指定 Version 操作的版本号 必选参数 调用GeCapabilitie的 URL 请求的服务实例 必选参数 Servicenstance 服务URL ProcessBrie数据结 操作过程的描述 对象值 必选参数 Process ProcessBrief 构(见表39 19
GB/T40525一2021 表38(续 参数名 描述 数据类型 取值范围 备注 数据结构 Status 见 操作状态 Status对象值 必选参数 StatuS 表40) 可选参数
当且 Process(Outputs数据 仅当Status值为 ProcessOutputs操作输出值 Process(Outputs对象值 结构序列见表41) ProcessSucceeded 时有输出值 表39ProcessBrier数据结构描述表 参数名 描述 数据类型 取值范围 备注 ldentifier 输出结果标识符 ows;CodeType 任意值 必选参数 输出结果名称 字符串 任意字符 必选参数 Title Abstract 输出结果摘要 字符串 任意字符 可选参数 表40Status数据结构 参数名 描述 数据类型 取值范围 备注 必选参数
如果操 reationTime 操作完成的时间 日期时间型 任意日期或时间 作未完成,该值为返 回文档的创建时间 ProcessAccepted 标示操作过程已接受 字符串 任意字符 可选参数 标示操作过程已接受并 ProcessStarted 字符串 任意字符 可选参数 已开始 ProcessPaused 字符串 任意字符 标示操作过程已暂停 可选参数" 标示操作过程已成功完 字符串 ProcessSucceeded 任意字符 可选参数" 成处理 标示操作过程执行失败 任意值 ProcessFailed ProcessFailed类型 可选参数" 五种元素有且只存在一种元素 包含操作执行错误信息,其参数为Exceptionkeport ,数据类型为字符串,取值范围是任意字符 表4 ProeessOutputs数据结构 参数名 描述 数据类型 取值范围 备注 ldentifier 输出结果标识符 ows;CodeType 任意值 必选参数 输出结果名称 字符串 任意字符 必选参数 Title 输出结果摘要 字符串 任意字符 可选参数 Abstract 20
GB/T40525一2021 表41(续 数据类型 取值范围 参数名 描述 备注 标示输出结果是网络可访间的OutputReference数据结构(见 Reference 任意值 可选参数" 链接 Data 标示输出结果直接包含在文档中 DataType数据结构(见表43)任意值 可选参数 两种元素有且只存在一种元素
表42Reference数据结构表 参数名 描述 数据类型 取值范围 备注 指向网络可访问的资源作为输人 href 字符串 任意值 必选参数 或输出数据 字符串 可选参数 输出结果的MIME类型 任意值 mmimeType encoding 输出结果编码 UR1类型 任意值 可选参数 表43DataType数据结构表 描述 数据类型 取值范围 备注 参数名 ComplexData 输人或输出值为复杂数据结构 复杂数据结构见表44 任意值 可选参数" LiteralData 输人或输出结果为文字 字符串 任意值 可选参数" 两种类型有且只能选择一种数据类型.
表44ComplexData数据结构表 描述 数据类型 取值范围 备注 参数名 any 用于输人或输出值的复杂数据 任意类型 任意值 必选参数 mimeType 输出结果的MIME类型 字符串 任意值 可选参数 encoding 输出结果编码 URI类型 任意值 可选参数 扩展服务要求 扩展服务是指不包含在基本服务范围内,地理信息共享平台建设所需的其他服务
扩展服务接口 规定了服务的具体实现方法,明确自定义扩展服务接口的输人、输出前置条件与效果 扩展服务接口的定义应满足以下要求 明确扩展服务接口实现的具体功能 a b) 规定服务的输人、输出、前置条件与效果等信息 优先使用或扩展已发布的特定的服务标准规范如wFs、wMs,wCS等数据发布服务或wPs c 数据操作服务; d 明确扩展服务接口的参数定义,应按照所选标准要求的接口函数及参数定义发布服务
21
GB/T40525一2021 附 录 A 资料性附录) 开放查询服务XL模式 开放查询的AIo响应XML模式 A.1 本附录包含OpenSeareh响应中ATOM聚合格式的XMI模式,服务器按照该模式提供的符合本 标准的响应才是有效的
模式中的注释和文本元素为资料性内容;如果与本标准正文相冲突,以正文为 准
schemaL.acation属性也是资料性内容 xmlversion="1.0”encoding="UrE-8"？ xs;schemaxmlns;xs="http://www.N好3.org/2001/xI.schema" elementFormDefault="qualified”targetNamespace="http://www.x3.org/2005/Atom" lns.atom X "http://www.M3.org/2005/Atom”xmlns:os="http://a9.com/-/spec/opensearch/1.1/" "http://www.georss s.org/(georss/10”xln=;:dc="http://purl.org/dc/elements/1.1” XImlns;georsS "http://www.3.org/XXML/1998/namespace" Xmns:Xxm工 xs;importnamespace=http://www.,w3.org/XML/1998/na /namespaceschemaIocation="xml.xsd" 通用属性定义 《xs;attributeGroupname="atomCommonAttributes"》 xs:attributeref="xml:base" xs;attributeref="xml:lang" xs;attributeGropref="atom;undefinedAttribute"八 /xs;attributeGroup 联系信息属性定义 《xs;complexTypename atomPersonConstruct"" Xs;sequence Xs;elementref atom;name”min0ccurs max0ccurs atom;ur max0ccurs "o" maxOccurs="unbounded" xs:qroupref 'atom:extensionElement xs，seauence ibut seGroup ref Sa时睡 "atom;atomCommonAttributes" xS;complexIype xs;elementname name”type xs:string type5 xs;string atom;atomBmailAddress" xs;el elementname "email”tyPe 日期时间信息属性定 xs:complexTypename="atomDateConstruct") xs;simpleContent 《xs;extensionbase="xs;dateTime" monAttributes”) xs:attributeGroupref="atom:atomComm 《/xs:extension /xs;simpleContent 22
GB/40525一2021 /xs;complexTypey 元素 --feed De")GB/T40525一202 xs;documentation 该名称subtitle包含一个对数据类型的详细描述
《/xs:documentation 《/xsannotation /xselement -updated元素 -- 《xs;elementname="updated”tye="atom;atomDateConstruct" Xs;annotation 《xs:documentation 该名称updated是一个日期时间型的元索
作为entry的子元素时用来指明该条记录对应的地 理信息数据存档时间或最后一次被更新的时间;作为feed的子元素时用来指明查询响应的生成 时间 /xs;documentation) /xs;annotation》 /xs;element》 author元素--y xs;elementname="author”type="atom;atomPersonConstruct" atom;id--》 xs;elementname="id"" ccomplexTypemixed="true" XS: 《xs;attributeGroupref="atom;atomCommonAttributes"八 /xs;complexType xs:annotation xs:docunentation》 该名称id用来指明标识符
作为entry的子元素时用来指明该条数据的名称;作为feed的子元 素时用来指明该数据产品的类型标识符
/xs;doeumentation) /xs;annotation 《/xs:element totalResult t8元素-) xs;elementname="totalResults”type="xs;integer" xsannotation xs;documentation) 该名称totalResults用来指明满足查询条件的记录数,如无则为0
/xs;documentation 《/Xs;annotation 《/xs;element》 一startIndex元素-- xs;elementname="startIndex”type="xs;integer" xs;annotation)y xs;documentation 该名称startIndex用来指明返回记录起始索引值
《/Xs;documentation 《/xs:annotation》 /xs:element》 24
GB/40525一2021 temsPerPage元素 (xs;elementname="itemsPerPage”type="xs;integer" xsannotation xs.documentation 该名称itemsPerPage用来指明每次返回的查询记录数
/xs;documentation)》 /xs;annotation)y 《/xs:element ！ -Query元索- ="Query") 《xs:elementname= xs;annotation》 xs;documentation 该名称Query用来指明本ATOM聚合文档对于OpenSearch查询请求的URL
/xs;documentationy /xs;annotation xs;attributeGroupname='gueryGroup' xs;attributenane request”type="xs;string" type="xs;string" xsattrbute 八 0l startRecord”type="xs;integer" Xs.t十TO1T中 inmRecord”tye="e;integer") xs;string tpe Xs;attributenane start”type xs;string xs;attributename endtype 《xs:attributeGroup 《/xs:element》 -box元素 xs;:elenentname="box”type="georss;box" xs;annotation) xs;documentation 该名称box用逗号分隔的字符串来表明该条数据对应的空间范围
其形式为“nt inx，miny,maxx.maxy”， ,数字的单位是经纬度
/xs;documentation 《/xs;annotation /xs;element》 ！ date元素 (xs;elementname="date"type="de;date" xs;annotation xs:documentation 该名称date用“/"分隔的字符串来表明该条数据对应的时间范围
其形式为“start/end”,时间的格式满足GB/T74082005的要求
/xs;documentation)y /xs;annotation) 《/xs:element 元素-) --link (xs;,elementname="link")y 25
GB/T40525一2021 xs;annotation xs:documentation 该名称1ink定义该数据资源相关的uRL链接地址
《/xs;documentation /xsannotation xs;complexType xs;complexContent》 xs;:extensionbase="atom;undefinedContent" XS十十7n17十o use="required" 八 "href name rel")(/xs;element xs;complexTypename="feedType" xs;sequence) xs;choicemaxOccurs="unbounded" 〈xs;elementref="atom;title" "atom;updated" ref xs:elementref="os:Query "atom;subtitle"y xs:elementref xsannotation xs:documentation 26
GB/40525一2021 subtitle元素用来描述具体的服务异常
《/Xs;documentation 《/xs:annotation /xs;element /xs;choice) /xs;sequence /xs;complexType》 /xs;schema) 27
地理信息在线共享接口规范GB/T40525-2021
随着互联网技术的不断发展，地理信息产业也逐渐迎来了新的机遇和挑战。地理信息在线共享接口规范GB/T40525-2021的发布正是为了更好地满足地理信息在线共享的需求，促进地理信息产业的健康发展。
GB/T40525-2021规范了地理信息在线共享接口的基本要求、功能模块、数据格式、标准接口等方面，为各类地理信息在线共享平台提供了统一的标准接口规范，使得不同平台之间的数据交换变得更加便捷和高效。
根据规范，地理信息在线共享接口主要包括以下功能模块：
- 用户管理：包括用户注册、登录、退出等功能；
- 数据目录管理：包括数据分类、目录查询、订阅等功能；
- 数据下载管理：包括数据下载、传输、安全验证等功能；
- 服务管理：包括服务发布、查询、订阅、调用等功能；
- 标准接口：包括数据获取接口、服务调用接口等。
在数据格式方面，规范统一了地理信息在线共享接口所使用的XML和JSON数据格式，并规定了详细的数据结构和数据元素定义，以便不同平台之间能够顺利地进行数据交换。
此外，规范还规定了一系列的标准接口协议，如WFS、WMS、WCS等，使得地理信息在线共享平台能够更加灵活地提供各种功能和服务。同时，规范还提出了相关的安全要求和保护措施，确保地理信息在线共享的安全性和可靠性。
总之，GB/T40525-2021规范的发布对于推动地理信息产业的健康发展、促进地理信息在线共享的普及和应用具有重要意义。未来，我们相信地理信息在线共享接口规范将会不断完善和更新，为地理信息产业的发展提供更加强有力的支撑。
