坡向分析(aspect)

POST

/rest/services/{servicename}/spatialanalysis/aspect

该算法从栅格表面的每个像元派生出坡向

示例1

{
        "dataset": {
            "datasourceName": "地形分析",
            "datasetName": "dem84.tif"
        },
        "outputType":2,
        "outDataset":
        {
            "datasourceName": "地形分析",
            "datasetName": "dem84_aspect.tif"
        },
        "aysn":false
    }

示例2

{
        "dataset": {
            "datasourceName": "地形分析",
            "datasetName": "dem84.tif"
        },
        "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 对象

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"
    },
    "outputType":2,
    "outDataset":
    {
        "datasourceName": "地形分析",
        "datasetName": "dem84_aspect.tif"
    },
    "aysn":false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Body

object {0}

示例

成功示例outPutType指定为1时成功示例outPutType指定为2时成功示例异步

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

修改于 2025-03-14 07:18:44

坡度分析(slope)

剖面分析(profile)