Execute 请求 |
SuperMap iServer WPS 服务目前提供了 POST 实现方式,即支持 POST 方式的 Execute 请求:
Execute 操作遵循 HTTP 协议,用户终端采用 KVP 编码格式向服务端提交请求,主要请求参数如下:
表1 Execute 操作请求主要参数
请求参数 | 是否必需 | 描述 |
SERVICE=WPS |
是 |
服务类型。 请求 WPS 服务,请求类型必需要设为“WPS”。 |
REQUEST=Execute |
是 |
请求操作的名称。 请求 Execute 操作,请求名称必需要设为“Execute”。 |
VERSION=version |
是 |
服务支持的版本号。 服务的版本号,必需设为“1.0.0”。 |
LANGUAGE=Language |
否 |
服务支持的语言名称。 必须在 Capabilities 的 Languages 元素中列出,例如:en-US,zh-CN。 |
IDENTIFIER=Identifier |
是 |
要查询的 Execute 操作的子操作的名称。 |
DATAINPUTS=DataInputs |
否 |
输入参数描述。 在 Input 节点中列出输入参数的详细描述。 |
RESPONSEFORM=ResponseForm |
否 |
指定返回结果文件类型,包括类型(ResponseDocument)和原始数据类型(RawDataOutput),暂只支持文档类型。 返回符合 GML2.1.2 和 GML3.2.1规范的 XML 文档,对交通换乘分析、交通网络分析功能,反回 JSON 文档。 |
STOREEXECUTERESPONSE=storeExecuteResponse |
否 |
布尔型值,默认值是 false。 是否存储返回的结果文档。 注:当指定返回的 WPS 响应类型为 ResponseDocument 类型时该参数才有效。 |
LINEAGE=lineage |
否 |
布尔型值,默认值是 false。 是否在响应结果中包含 DataInputs 和 OutputDefinitions 元素。 注:当指定返回的 WPS 响应类型为 ResponseDocument 类型时该参数才有效。 |
STATUS=status |
否 |
布尔型值。 是否返回响应结果的状态,暂不支持。 |
Execute 操作暂不支持 GET 请求。
Execute 操作遵循 HTTP 协议,用户终端也可采用 post 方式向服务端提交请求,例如,本机 SuperMap iServer WPS 1.0.0 服务启动成功之后,POST 访问 Execute 操作的 URI 的地址为:http://localhost:8090/iserver/services/spatialanalyst-changchun/wps100?SERVICE=WPS&REQUEST=Execute&VERSION=1.0.0 。
请求体示例如下:
在请求体中<wps:Reference>节点既支持以 URI 文件的方式,也支持 XML 方式,例如:请求体中的<wps:Reference xlink:href="http://localhost:8090/iserver/services/data-world/wfs100?SERVICE=WFS&VERSION=1.0.0&REQUEST=GetFeature&TYPENAME=World:Capitals"/>可修改为:<wps:Reference xlink:herf="http://localhost:8090/iserver/output/xml/WFS_request.xml"/>。
在请求体中 WFS_request.xml 文件内容如下:
该请求示例的响应结果请参见响应示例。