剖面分析(profile)

POST

/rest/services/{servicename}/spatialanalysis/profile

该算法根据给定的线路查看栅格表面沿该线路的剖面，并得到剖面线。

请求参数

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 对象

line

object (数据集连接对象)

必需

路线数据，可以是一条或多条线的geojson对象，也可以是线要素集。具体参见 “数据集信息datasetinfo” 数据集信息datasetinfo

lineFilter

object (Filter)

可选

源数据过滤条件,当line为线要素集时该参数有效。

where

string

可选

查询条件，使用url编码之后的字符串，例如 PAC=420804 or PAC=420802

geometry

string

可选

查询几何对象，geojson格式字符串，具体参见 “geojson 对象” geojson 对象
此参数如果在设置了query_define 中的geometry 参数后，会无效，会被覆盖。需要对字符串进行转义，例如：{ "type": "Polygon", "coordinates": [ [ [ 111.989792031851962, 31.427141945448305 ], [ 111.556656081144411, 30.94937986648603 ], [ 112.147296013927445, 30.639622035070929 ], [ 112.562056500059526, 30.999256127476599 ], [ 111.989792031851962, 31.427141945448305 ] ] ] }

subfields

string

可选

查询返回的字段，以逗号隔开，如果为空，则返回所有字段，例如：PAC,NAME

GroupByClause

string

可选

分组条件，sdk底层支持，传入参数字段名称，多个字段以 , 逗号分割，例如 id,name

OrderByClause

string

可选

排序条件，sdk底层支持，传入参数字段名称 + desc/asc，多个字段排序使用 , 逗号分割。举例： id desc,name asc

SpatialRel

string

可选

查询空间判断过滤类型

limit

string

可选

制返回数量，默认全部返回，如果传值小于0 则设置为200

Fids

array[string]

可选

过滤要素id数组,优先级最高

geoSRS

string

可选

几何的空间参考信息，查询几何空间参考，支持EPSG、WKT、proj4字符串参数，例如epsg类型 EPSG:4490

outPutType

integer

必需

分析结果输出类型，
1代表输出到全局数据源；
2代表输出到当前服务指定数据源的数据集；
3代表输出"GeometryCollection"或"FeatureCollection"的GeoJson对象。

outSRS

string

可选

生成数据集的空间参考

outDataset

object (数据集连接对象)

可选

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

aysn

boolean

可选

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

示例

{
    "dataset": {
        "datasourceName": "栅格数据",
        "datasetName": "dem84.tif"
    },
    "line":{
        "geometry": {
            "type": "GeometryCollection",
            "geometries": [
                {
                    "type":"MultiLineString",
                    "coordinates":[
                        [
                            [101.6680413127,36.511067975],
                            [101.6771503817,36.5126567665],
                            [101.6783949347,36.5159932278]
                        ]
                    ]
                }
            ]
        },
        "geoSRS": "EPSG:4326"
    },
    "outputType":2,
    "outDataset":
    {
        "datasourceName": "栅格数据",
        "datasetName": "dem84_profile.shp"
    },
    "aysn":true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rest/services//spatialanalysis/profile' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dataset": {
        "datasourceName": "栅格数据",
        "datasetName": "dem84.tif"
    },
    "line":{
        "geometry": {
            "type": "GeometryCollection",
            "geometries": [
                {
                    "type":"MultiLineString",
                    "coordinates":[
                        [
                            [101.6680413127,36.511067975],
                            [101.6771503817,36.5126567665],
                            [101.6783949347,36.5159932278]
                        ]
                    ]
                }
            ]
        },
        "geoSRS": "EPSG:4326"
    },
    "outputType":2,
    "outDataset":
    {
        "datasourceName": "栅格数据",
        "datasetName": "dem84_profile.shp"
    },
    "aysn":true
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

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

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

修改于 2025-03-14 07:19:22

坡向分析(aspect)

曲率计算(curvature)