curvature

URI

<terrainCalculation_uri>/curvature[.<format>]

支持的方法

GET、POST、HEAD

父资源

terrainCalculation

子资源

curvatureResult

介绍

对指定的栅格数据执行一次曲率计算。

地形曲率是表达地形曲面结构的主要参数之一。DEM 栅格数据每个像元的表面曲率，是通过将目标像元与八个相邻像元拟合为二次曲面，再对此拟合曲面求（0,0）位置处的曲率而得。   

通过当前资源可计算平均曲率数据集、剖面曲率（即沿最大斜率方向的曲率）数据集、平面曲率（即垂直于最大斜率方向的曲率）数据集。输出的三种曲率数据集都是和原数据集等大且分辨率相同的数据集。

支持的方法：

支持的表述格式：RJSON、JSON、HTML、XML。

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/JingjinHillshade@Jingjin/terraincalculation/curvature.rjson

GET 请求

获取进行曲率计算的表单。

POST 请求

对指定的栅格数据执行一次曲率计算。

请求参数

在请求体中传递参数如下所示：

名称 类型 含义
deleteExistResultDataset boolean 如果用户命名的结果数据集名称与已有的数据集重名，是否删除已有的数据集。
averageCurvatureName String 【必选参数】
指定输出平均曲率数据集的名称。
profileCurvatureName String 输出剖面曲率数据集的名称。
planCurvatureName String 输出平面曲率数据集的名称。
zFactor double 指定的高程缩放系数。默认值为 1.0，表示不缩放。
该值是指在 DEM 栅格数据中，栅格值（Z 坐标，即高程值）相对于 X 和 Y 坐标的单位变换系数。通常有 X，Y，Z 都参加的计算中，需要将高程值乘以一个高程缩放系数，使得三者单位一致。例如，X、Y 方向上的单位是米，而 Z 方向的单位是英尺，由于 1 英尺等于 0.3048 米，则需要指定缩放系数为 0.3048。

响应结构

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

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

响应示例

对 curvature 资源 http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/JingjinTerrain%40Jingjin/terraincalculation/curvature.rjson，执行 POST 请求，发送 rjson 格式请求体如下：

{

    "zFactor": 1,

    "averageCurvatureName": "test1",

    "profileCurvatureName": "test2",

    "planCurvatureName": "test3",

    "deleteExistResultDataset": false

}

则返回的 rjson 格式响应结果如下：

{

    "succeed": true,

    "newResourceID": "6b7fe42a934c49fa93fe5b8b7541d2db_e9e94b4996c247798d7d0f985e6f0c1a",

    "postResultType": "CreateChild",

    "newResourceLocation": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/JingjinTerrain@Jingjin/terraincalculation/curvature/6b7fe42a934c49fa93fe5b8b7541d2db_e9e94b4996c247798d7d0f985e6f0c1a"

}

对响应结果中的子资源 http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/JingjinTerrain@Jingjin/terraincalculation/curvature/6b7fe42a934c49fa93fe5b8b7541d2db_e9e94b4996c247798d7d0f985e6f0c1a.rjson 执行 GET 请求，即可查看分析结果并获取结果数据集的信息。

HEAD 请求

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

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

请参见