坡度分析(slope)

POST

/rest/services/{servicename}/spatialanalysis/slope

该算法计算栅格中每个像元的坡度

示例1

{
        "dataset": {
            "datasourceName": "地形分析",
            "datasetName": "dem84.tif"
        },
        "ouput_measurement":"degree",
        "z_factor":1,
        "outputType":2,
        "outDataset":
        {
            "datasourceName": "地形分析",
            "datasetName": "dem84_slope.tif"
        },
        "aysn":false
    }

示例2

{
        "dataset": {
            "datasourceName": "地形分析",
            "datasetName": "dem84.tif"
        },
        "ouput_measurement":"degree",
        "z_factor":1,
        "extend":
        {
            "type":"Point",
            "coordinates":[39536343.1491770820000,3345453.4753159322000]
        }
  }

请求参数

Path 参数

servicename

string

必需

Body 参数application/json

dataset

object (数据集连接对象)

必需

地形栅格源数据集,需要检查数据集必须带空间参考信息，否则直接返回未检查到有效空间参考的错误信息。具体参见 “数据集信息datasetinfo” 数据集信息datasetinfo

layerid

string

可选

图层id，通过地图服务配置方式发布下可用，优先级最高

datasourceName

string

数据源名称

可选

datasourceID

string

可选

数据源ID ，和datasourceName功能相同，用于确定数据源。二选一，优先级高于datasourceName。

datasetName

string

数据集名称

可选

datasetID

string

可选

每个数据集对应一个唯一标识ID，可替换数据源名称+数据集名称，确定一个唯一数据集。效果可数据源名称+数据集名称相同。二选一，优先级高，规则参考数据服务中的id规则。

geometry

string

可选

Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection类型的GeoJson对象具体参见 “geojson 对象” geojson 对象

ouput_measurement

string

可选

输出坡度数据的测量单位。degree:坡度倾角将以度为单位进行计算；percent:坡度倾角将以增量百分比进行计算，也称为百分比坡度

z_factor

number

可选

高程缩放系数:一个表面 z 单位中地面 x,y 单位的数量。
z 单位与输入表面的 x,y 单位不同时，可使用 z 因子调整 z 单位的测量单位。计算最终输出表面时，将用 z 因子乘以输入表面的 z 值。
如果 x,y 单位和 z 单位采用相同的测量单位**，则 z 因子为 1。这是默认设置。**
如果 x,y 单位和 z 单位采用不同的测量单位，则必须将 z 因子设置为适当的因子，否则会得到错误的结果。例如，如果 z 单位是英尺而 x,y 单位是米，则应使用 z 因子 0.3048 将 z 单位从英尺转换为米（1 英尺 = 0.3048 米）。取值范围0~1.0。

outPutType

integer

可选

当输出结果是栅格时，需要指定输出类型。分析结果输出类型：
1代表输出到全局数据源；
2代表输出到当前服务指定数据源的数据集；

outSRS

string

可选

生成数据集的空间参考

outDataset

object (数据集连接对象)

可选

结果保存路径。当outPutType指定为2时，该参数有效。指定输出的结果栅格数据集信息。具体参见 “数据集信息datasetinfo” 数据集信息datasetinfo

aysn

boolean

可选

是否异步执行，如果异步执行，直接返回任务id，通过任务状态查询返回结果。默认同步

extend

object

可选

限定计算的范围，geojson格式的多边形或者点具体参见 “geojson 对象” geojson 对象。空间参考使用extendSRS参数。主要是用于数据量较大时，限定局部范围。默认采用整个栅格数据集范围。如果是点，直接返回该点处的坡度

extendSRS

string

可选

extend的空间参考，可选，默认使用栅格数据集的空间参考

示例

{
    "dataset": {
        "datasourceName": "地形分析",
        "datasetName": "dem84.tif"
    },
    "ouput_measurement":"degree",
    "z_factor":1,
    "outputType":2,
    "outDataset":
    {
        "datasourceName": "地形分析",
        "datasetName": "dem84_slope.tif"
    },
    "aysn":false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rest/services//spatialanalysis/slope' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dataset": {
        "datasourceName": "地形分析",
        "datasetName": "dem84.tif"
    },
    "ouput_measurement":"degree",
    "z_factor":1,
    "outputType":2,
    "outDataset":
    {
        "datasourceName": "地形分析",
        "datasetName": "dem84_slope.tif"
    },
    "aysn":false
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

成功示例outPutType指定为1时成功示例outPutType指定为2时成功示例异步extend为Point时的结果

{
    "resultcode": "success",
    "time": 0.343,
    "result": {
        "datasetName": "s_slope_48baf94794248c38776711d859164af"
    }
}

修改于 2025-03-14 07:17:59

阴影分析(shade)

坡向分析(aspect)