gridDatasetBasicStatisticsResults

URI

<gridDatasetStatisticsAnalyst_uri>/gridbasicstatistics[.<format>]

支持的方法

GET、POST、HEAD

父资源

gridDatasetStatisticsAnalyst

子资源

gridDatasetBasicStatisticsResult

介绍

基于栅格数据集计算每个像元的基本统计信息进行统计。对该资源发送POST请求，则可以返回一个统计结果资源，内容包括最大值、最小值、平均值、标准值、方差。

支持的方法：

GET：html 表述返回一个 POST 请求的表单，其他表述返回栅格基本统计结果集列表。
POST：创建一个栅格基本统计结果资源，相当于进行了一次统计分析。
HEAD：检查 gridDatasetBasicStatisticsResults 资源是否存在，或权限是否可以访问 gridDatasetBasicStatisticsResults 资源。

支持的表述格式：rjson、json、jsonp、html、xml。

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/spatialAnalysis-Jingjin/restjsr/spatialanalyst/datasets/JingjinTerrain%40Jingjin/gridstatistics/gridbasicstatistics.rjson

GET 请求

html 表述返回一个 POST 请求的表单，其他表述返回栅格基本统计结果集列表。

POST 请求

创建一个栅格基本统计结果资源，相当于进行了一次统计分析。

请求参数

描述执行 POST 请求时，请求体需包含如下参数：

名称	类型	含义
functionType	String	【必选参数】函数转换。支持选填三种参数值： 1、NONE，即不使用函数转换； 2、LOG，对栅格值进行对数（Log）转换。使用此函数时，栅格数据集的值域最小值需要大于0； 3、ARCSIN，对栅格值进行反正弦函数（ArcSin）转换。使用此函数时，栅格数据集的值域需要在 [-1,1] 之内。请注意：进行函数转换时，用来统计的数据是原始栅格值经过函数变换后得到的值。

响应结构

正常响应情况：响应码201。响应参数如下：

字段	类型	说明
succeed	Boolean	查询是否成功。
newResourceID	String	分析结果资源的 ID。
postResultType	PostResultType	POST 请求的结果类型，枚举说明 POST 请求对目标资源的影响，即处理结果是什么样的。
newResourceLocation	String	创建的新资源的 URI。

响应示例

对 gridDatasetBasicStatisticsResults 资源执行 POST 请求，即对 http://localhost:8090//iserver/services/spatialAnalysis-Jingjin/restjsr/spatialanalyst/datasets/JingjinTerrain%40Jingjin/gridstatistics/gridbasicstatistics.rjson 提交请求体如下：

{

"functionType":"NONE"

}

则返回的 rjson 格式的响应信息如下：

{

"succeed": true,

"newResourceID": "e6cbd1d212bc4e3ab217ca3ee32bbdf9_740b9cd1538e4ab9b0d65f71a48c7c70",

"postResultType": "CreateChild",

"newResourceLocation": "http://localhost:8090/iserver/services/spatialAnalysis-Jingjin/restjsr/spatialanalyst/datasets/JingjinTerrain@Jingjin/gridstatistics/gridbasicstatistics/e6cbd1d212bc4e3ab217ca3ee32bbdf9_740b9cd1538e4ab9b0d65f71a48c7c70"

}

对 http://localhost:8090//iserver/services/spatialAnalysis-Jingjin/restjsr/spatialanalyst/datasets/JingjinTerrain%40Jingjin/gridstatistics/gridbasicstatistics.rjson ,执行 GET 请求，即可获取点密度插值分析结果的具体信息。请参见 gridDatasetBasicStatisticsResult。

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 gridDatasetBasicStatisticsResults 资源是否存在，或者客户端是否有权限访问 gridDatasetBasicStatisticsResults 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 gridDatasetBasicStatisticsResults 资源是否支持<format>格式的表述。