文化部制定文化市场地理信息基础应用系统CultureGIS服务接口规范Word文件下载.docx
- 文档编号:17324641
- 上传时间:2022-12-01
- 格式:DOCX
- 页数:37
- 大小:385.42KB
文化部制定文化市场地理信息基础应用系统CultureGIS服务接口规范Word文件下载.docx
《文化部制定文化市场地理信息基础应用系统CultureGIS服务接口规范Word文件下载.docx》由会员分享,可在线阅读,更多相关《文化部制定文化市场地理信息基础应用系统CultureGIS服务接口规范Word文件下载.docx(37页珍藏版)》请在冰豆网上搜索。
4.文化市场地理信息服务使用安全规范16
5.文化市场地理信息REST服务接口17
5.1安全认证服务18
5.1.1Login登录18
5.1.2Logout19
5.2地图REST服务21
5.2.1HTTP请求方法21
5.2.2GET请求21
5.2.3HEAD请求22
5.3数据REST服务22
5.3.1HTTP请求方法23
5.3.2GET请求23
5.4空间分析REST服务23
5.4.1属性查询24
5.4.2空间查询24
5.4.3缓冲区分析25
5.4.4叠加分析26
5.5交通网络分析REST服务28
5.5.1网络分析服务28
5.5.2最佳路径分析29
5.6地名地址解析REST服务31
5.6.1服务说明31
5.6.2匹配服务31
5.6.3正向地址匹配31
5.6.4逆地址编码32
5.7目录服务接口规范33
5.7.1服务说明33
5.7.2服务分类33
5.7.3元数据目录服务33
5.7.4元数据属性服务34
5.7.5请求所有目录XML34
5.7.6节点属性服务请求XML34
5.7.7图层元数据服务请求XML35
5.8地图API服务1
5.8.1服务说明1
5.8.2地图API主要服务类参考1
1.范围
为了确保文化市场地理信息系统的基础性和公用性,必须参照国际、国家、地方和行业的有关标准,建立统一的标准和共同遵守的管理和服务流程规范,使公用性、基础性的数据库以及在此之上构建的信息服务和数据交换接口的能为文化部各部门及社会各行各业所接受和使用。
2.本规范引用标准文件
◆《ArchitecturalStylesandtheDesignofNetwork-basedSoftwareArchitectures》(中文版《架构风格与基于网络的软件架构设计》
◆OGCSFS-简单要素标准;
◆OGCWMTS
◆OGCWebCoverageProcessingService标准;
◆OGCWebFeatureService标准;
◆OGCWebCoverageService标准;
◆OGCWebMapService标准;
◆OGCWebServiceCommon标准;
◆WebService标准:
WS-IBasicProfile1.1、SOAP1.2、WSDL2.0、WS-Addressing1.0;
◆XML1.0。
3.文化市场地理信息服务接口总体设计
文化市场地理信息系统与文化市场技术监管系统通过接口方式进行对接,实现互联互通、功能融合和应用集成。
已有的文化市场技术监管系统可以通过地图API和服务接口,在系统中嵌入地图,并且实现在地图上的查询、统计、分析等应用模块的功能。
文化市场地理信息服务平台提供REST服务接口和OGC标准地理信息服务接口,以满足各应用系统对地图访问、操作的需求。
地图REST服务
地图REST服务提供maps资源及其子资源map、layers,算法资源area、distance等,这些资源可以对地图和图层进行访问与操作。
数据REST服务
数据REST服务提供data资源及其子资源datasources和featureResults,这些资源可以对空间数据进行访问与操作。
查询分析服务
spatialAnalyst资源是空间分析功能的根资源,通过对spatialAnalyst资源执行GET请求可以获取地理信息服务平台服务器上空间分析所有支持的接口。
交通网络分析REST服务
交通网络分析REST服务提供networkanalyst资源及其networkDataName、edgeweightnames等子资源,提供了交通网络分析服务。
地名地址解析REST服务
地名地址解析REST服务提供正向地址匹配服务、逆地址编码等服务。
4.文化市场地理信息服务调用流程及接口规范
调用GIS服务流程
地理信息服务平台的REST服务内部工作主要分为验证、解析HTTP、请求处理以及结果编排返回几个过程,这些过程分别由REST服务内部的认证管理器、资源、参数解析器、资源HTTP处理器、表述生成器完成,客户端向REST服务提交的请求分别经由这些组成部分处理,最终形成处理结果返回给客户端,如下图所示。
REST服务接口规范
支持的HTTP方法
图支持方法
SuperMapiServer服务器会对客户端HTTP请求做出响应,支持其GET、POST、HEAD和DELETE方法。
客户端执行GET请求,获得资源的表述,客户端执行PUT、POST、DELETE请求,获得操作结果的表述。
支持的表述格式
图支持的表述格式
表述可以有多种格式,如html、xml、json、rjson、png、bmp、gif、jpg或jpeg等,其中png、bmp、gif、jpg或jpeg是图片资源特有的表述格式。
状态码列表及说明
客户端向地理信息服务平台服务器发送HTTP请求时,地理信息服务平台服务器会根据请求的类型返回响应结果,通过响应结果中的状态码,客户端可以得知请求的处理情况。
例如:
是否成功、出错的原因,等等。
HTTP协议定义了各个状态码代表的意义,官方定义有41种状态码,分5类,如下:
◆1xx:
信息性——收到请求,继续处理
◆2xx:
成功性——成功收到、理解并接受行动
◆3xx:
重定向——必须采取进一步行动来完成请求
◆4xx:
客户端错误——请求包含错误语法或不能完成
◆5xx:
服务器错误——服务器没有成功完成显然有效的请求
地理信息服务平台主要用到其中的2xx系列、4xx系列和5xx系列,各个状态码的含义如下表所示:
状态码值
含义
200
表示服务器成功执行了客户端的HTTP请求。
如果请求的类型是GET说明获取资源成功,是PUT说明修改资源成功,是DELETE说明删除资源成功,是HEAD说明获取资源的元数据成功。
201
表示服务器按客户端的请求成功创建了一个新资源。
对应的请求类型是POST或PUT。
注意,这时返回的信息中会包含Location报头,指向新创建资源的规范URI。
303
表示服务器将客户端的请求重定向到另一个URI,要完成请求必须进行进一步操作。
例如,在访问image资源时,redirect参数为true(默认值)则表示重定向图片,URI如下:
http:
//supermapiserver:
8090/iserver/services/map-world/rest/maps/WorldMap/image.png?
center={"
x"
:
103,"
y"
34}&
scale=0.00000002&
redirect=true
HTTP响应的状态码为303,并重定向到图片地址。
400
表示客户端的请求参数不合法或没有表达足够的信息。
例如,对layers资源执行POST操作创建一个新的图层,即layer资源,但如果没有在请求体里给出创建新图层必须的参数,即图层的描述信息,这时就会得到响应码400。
401
表示因为安全的原因,导致对资源的操作没有完成。
例如,删除数据集,可以对dataset资源执行DELETE请求(包含参数),URI如下:
8090/iserver/services/data-world/rest/data/datasources/name/World/datasets/name/Countries.rjson
而创建新图层需要管理员权限,假设某个客户端没有这个权限,当它执行以上请求时,就会得到响应码401。
404
表示客户端请求的资源不存在,即URI无效。
例如,在获取名为World的map资源时,对如下URI执行GET请求:
8090/iserver/services/components-rest/rest/maps/World.json
正常返回响应码200,说明成功获取资源;
但当服务器(server)里根本没有名为World的map资源时,就会返回响应码404,表示资源无效。
405
表明资源不支持该操作。
对maps资源执行PUT和DELETE请求会得到响应码405,表示maps资源对PUT和DELETE不支持。
406
表示资源不支持客户端请求的表述格式(参见地理信息服务平台RESTAPI输出格式介绍)。
例如,在获取maps资源时,对如下URI执行GET请求:
8090/iserver/services/components-rest/rest/maps.bmp
因为maps不是图片资源,所以不支持BMP的表述格式,这时就会得到响应码406。
500
表示服务器端发生非预期情况,导致请求没有完成。
5.文化市场地理信息服务使用安全规范
目前,地理信息服务平台所有的REST服务、OGC服务都支持基于Token的认证。
服务开启安全控制后,访问服务时就需要在请求地址中携带Token令牌,具体使用方法可参考基于Token访问受保护的REST服务资源。
REST服务是基于网络的,任何客户端通过URI都可以访问REST服务的各种类型的资源,甚至有些资源支持客户端对GIS数据进行编辑操作,因此必须在REST服务器端设置安全机制,用于保护GIS数据、保证REST服务不被恶意破坏。
地理信息服务平台REST服务在安全机制环节专门设置了认证器,认证器是客户端请求到达REST服务后首先执行的程序,认证器主要作用是对客户端的身份进行合法性验证,只有通过身份验证的客户端请求才能够与REST服务进行交互,对于非法身份的客户端将其提交的请求驳回,认证器能够有效保证REST服务的安全。
地理信息服务平台提供一个默认认证器,该认证器是由类com.supermap.services.rest.HTTPBasicAuthorizer来实现认证过程的。
默认认证器负责如下工作:
获取标准身份的列表
身份校对的标准被存储在SuperMapiServer安装目录的webapps\iserver\WEB-INF\lib\iserver-all-{version}.jar的config\rest下password.properties文件中,用户可以向该文件中添加多个可以访问REST服务的合法身份信息,其格式为[用户名]=[密码]。
默认认证器通过读取password.properties文件从而获得可以访问REST服务的身份列表。
解析客户端输入的身份信息
默认认证器解析客户端传入的身份验证的信息。
进行身份验证。
默认认证器将解析的客户端传入的身份信息与身份列表的信息进行对比,如果身份列表中有匹配的用户,那么将该客户端请求转给资源。
反之,认证器生成一个响应码用于说明客户端提交的身份不合法,并将响应码返回给客户端。
说明:
SuperMapiServer提供给用户的是一个默认的认证器,如果用户对于认证条件、认证方式有特殊的需求,可以通过扩展默认认证器的类com.supermap.services.rest.HTTPBasicAuthorizer,重新将特定的认证方式写入认证器中。
6.文化市场地理信息REST服务接口
地理信息服务平台将REST服务的各种资源按照一定的层次结构组织和发布,root资源是所有REST服务的根资源,地理信息服务平台提供的地图REST服务、数据REST服务、空间分析REST服务以及三维REST服务都作为root资源的子资源。
root资源支持GET、HEAD操作,通过对root资源的GET操作,可以获取所有发布的REST服务的目录,HEAD请求可以用来判断root资源是否存在,或者客户端是否有权限访问root资源。
安全认证服务
安全认证服务,为用户提供登录的另一种方式。
系统中一些操作只有特定的用户才能使用,在基于本系统做的一些开发时,特定用户操作自身开发的模块前可以通过该功能自动登录系统。
Login登录
0.1.1.1.服务说明
服务器登录页面,服务管理器等受保护的页面需要登录并验证身份后才能访问。
0.1.1.2.HTTP请求方法
对如下URI执行HTTP请求,以rjson输出格式为例加以说明,其中,supermapiserver是服务器名。
8090/iserver/services/security/login.rjson
GET请求
获取登录的表单。
POST请求
提交用户名密码进行登录。
请求参数
发送请求时,需要在请求体中包含如下参数:
名称
类型
username
String
【必选参数】
用户名。
password
密码。
rememberme
boolean
记住我。
如果为true,系统会记住用户的登录状态,下次打开页面不需要重复登录。
默认为false。
响应结构
描述
字段
说明
succeed
是否成功登录。
referer
登陆后跳转的页面。
Logout
logout资源用于退出登录状态。
⏹HTTP请求方法
8090/iserver/services/security/logout.rjson
⏹GET请求
退出登录状态。
⏹响应示例
对logout资源执行GET请求:
//localhost:
8090/iserver/services/security/logout.rjson,则可以直接退出登录状态,再访问服务管理器等页面时需要重新登录。
HTTP请求方法
8090/iserver/services/map-world/rest/maps.rjson
获取地图列表,包括地理信息服务平台服务器上地图的名称、URI、资源类型等。
⏹请求参数
_cache
【可选参数】
是否使用缓存,默认为true。
如果为false,则关闭所有缓存。
⏹响应结构
对maps资源执行GET请求,在响应消息的实体主体里是一个地图描述集,其中单个地图描述的结构如下:
name
地图的名称。
path
地图资源的访问路径。
resourceConfigID
资源配置项ID。
resourceType
资源类型。
supportedMediaTypes
String[]
支持的表述的媒体类型。
HEAD请求
返回跟GET请求一样的HTTP响应头,但是没有响应实体。
可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。
元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD请求可以用来判断maps资源是否存在,或者客户端是否有权限访问maps资源。
通过对加.<
format>
的URI执行HEAD请求,还可以快速判断maps资源是否支持<
格式的表述。
8090/iserver/services/data-world/rest/data.rjson
获取子资源信息列表,这里包括数据源集合资源、数据查询资源等。
子资源信息里包含资源名称、URI等。
无。
对data资源执行GET请求,在响应消息的实体主体里是一个子资源描述集,其中单个子资源描述的结构如下:
资源的名称。
资源的访问路径。
空间分析REST服务
空间分析REST服务,提供spatialAnalyst资源及其子资源datasets、geometry等,这些资源可以分别提供对于数据集、几何对象的空间分析服务。
属性查询
用户根据多种查询条件查询自己感兴趣的属性数据,返回符合条件的查询结果XML,此服务基于HTTP协议。
⏹请求URL
//23.36.21.4:
7080/DataPlatForm/service/DataService?
action=PropertyQuery&
QueryExp=362&
PageSize=10&
CurrentPageIndex=1
⏹请求参数说明
参数
备注
QueryExp
查询范围
PageSize
页面大小
CurrentPageIndex
当前页面索引
空间查询
空间查询语言是GIS的一个重要研究领域,GIS的查询源于数据库的查询。
数据查询语言的进展以及目前空间查询语言的研究成果,空间查询语言一般可分为三个方面:
扩展SQL、可视化查询和基于自然语言的查询。
通过大量分析的研究成果以及GIS本身的特点,我们认为空间数据库查询不等同于GIS的查询,前者仅是后者子集。
GIS查询应具有数据查询和基本空间分析功能。
GIS查询应具备的三个条件:
1.理解空间概念的数据模型;
2.具有宽广查询空间的查询基础模型;
3.查询结果的有意义表示。
7080/DataPlatForm/Service/DataService?
action=SpatialQuery&
QueryExp=10&
PageSize=&
CurrentPageIndex=1&
GML=107.44241699451254;
29.572677039871582;
100
action=SpatialQuery
执行的动作:
GML
空间范围坐标串
地理标记语言
缓冲区分析
以点实体为基础,自动建立其周围一定宽度范围内的缓冲区多边形图层,然后建立该图层与目标图层的叠加,进行分析而得到所需结果。
它是用来解决邻近度问题的空间分析工具之一。
邻近度描述了地理空间中两个地物距离相近的程度。
7080/DataPlatForm/Service/SpatialAnalystService?
action=BufferAnalyst&
GML=107.44241699451254;
action=BufferAnalyst
缓冲区
叠加分析
叠加分析是GIS中的一项非常重要的空间分析功能。
是指在统一空间参考系统下,通过对两个数据进行的一系列集合运算,产生新数据的过程。
这里提到的数据可以是图层对应的数据集,也可以是地物对象。
叠加分析的目的就是通过对空间数据的加工或分析,提取用户需要的新的空间几何信息。
在叠加分析中至少涉及到三个数据,其中一个数据的类型可以是点、线、面等,被称作输入数据;
另一个数据是面数据被称作叠加数据;
还有一个数据就是叠加结果数据,包含叠加后数据的几何信息和属性信息。
叠加分析参数,如叠加分析的操作类型、要进行叠加分析的图层的名称、要进行操作的图层名称等。
在矢量叠加分析中至少涉及到三个数据集,其中一个数据集的类型可以是点、线、面等,被称作输入数
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 文化部 制定 文化市场 地理 信息 基础 应用 系统 CultureGIS 服务 接口 规范
![提示](https://static.bdocx.com/images/bang_tan.gif)