视域分析(viewshed)

POST

/rest/services/{servicename}/spatialanalysis/viewshed

可视域是从一个或者多个观察点的可以看见的地表范围。可视域分析是在栅格数据数据集上，对于给定的一个观察点，基于一定的相对高度，查找给定的范围内观察点所能通视覆盖的区域，也就是给定点的通视区域范围，分析结果是得到一个栅格数据集。

请求参数

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

viewinfos

object

观察点信息数组

必需

viewPoint

object

可选

观察点，geojson 点对象数组，具体参见 “geojson 点对象” geojson 点对象，可选，支持z，默认为栅格位置的高程值

offsetA

number

可选

观察点附加高程（可选），单位米，默认值1。

offsetB

number

可选

栅格附加高程（可选），单位米，默认值0。

azimuth1

number

可选

起始方位角（可选），正北方向，顺时针，单位度，默认值0。

azimuth2

number

可选

终止方位角（可选），单位度，默认值360。

vert1

number

可选

终止垂直角（可选），单位度，默认值90。

vert2

number

可选

起始垂直角（可选），单位度，默认值-90。

radius1

number

可选

起始距离（可选），单位米，默认值0。

radius2

number

可选

终止距离（可选），单位米。

geoSRS

string

必需

viewPoint空间参考，可选，默认使用地形数据集的空间参考。

common

boolean

是否计算共同可视域

可选

outPutType

integer

必需

分析结果输出类型，
1代表输出到全局数据源；
2代表输出到当前服务指定数据源的数据集

outSRS

string

可选

生成数据集的空间参考

outDataset

object (数据集连接对象)

可选

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

aysn

boolean

可选

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

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 米

示例

{
    "dataset": {
        "datasourceName": "地形分析",
        "datasetName": "dem84.tif"
    },
    "viewinfos": [
        {
            "viewPoint": {
                "type": "Point Z",
                "coordinates": [
                    101.6745411,
                    36.5119804,
                    2449.207
                ]
            },
            "offsetA": 1.8,
            "offsetB": 0,
            "azimuth1": 0,
            "azimuth2": 120,
            "vert1": 40,
            "vert2": -40,
            "radius1": 0,
            "radius2": 200,
            "geoSRS": "EPSG:4326"
        },
        {
            "viewPoint": {
                "type": "Point Z",
                "coordinates": [
                    101.6692602973,
                    36.5180437853,
                    2600
                ]
            },
            "offsetA": 1.8,
            "offsetB": 0,
            "azimuth1": 0,
            "azimuth2": 120,
            "vert1": 40,
            "vert2": -40,
            "radius1": 0,
            "radius2": 500,
            "geoSRS": "EPSG:4326"
        }
    ],
    "outPutType": 2,
    "common": true,
    "outDataset": {
        "datasourceName": "地形分析",
        "datasetName": "dem84_viewshed.tif"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rest/services//spatialanalysis/viewshed' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dataset": {
        "datasourceName": "地形分析",
        "datasetName": "dem84.tif"
    },
    "viewinfos": [
        {
            "viewPoint": {
                "type": "Point Z",
                "coordinates": [
                    101.6745411,
                    36.5119804,
                    2449.207
                ]
            },
            "offsetA": 1.8,
            "offsetB": 0,
            "azimuth1": 0,
            "azimuth2": 120,
            "vert1": 40,
            "vert2": -40,
            "radius1": 0,
            "radius2": 200,
            "geoSRS": "EPSG:4326"
        },
        {
            "viewPoint": {
                "type": "Point Z",
                "coordinates": [
                    101.6692602973,
                    36.5180437853,
                    2600
                ]
            },
            "offsetA": 1.8,
            "offsetB": 0,
            "azimuth1": 0,
            "azimuth2": 120,
            "vert1": 40,
            "vert2": -40,
            "radius1": 0,
            "radius2": 500,
            "geoSRS": "EPSG:4326"
        }
    ],
    "outPutType": 2,
    "common": true,
    "outDataset": {
        "datasourceName": "地形分析",
        "datasetName": "dem84_viewshed.tif"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

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

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

修改于 2025-03-14 07:12:31

设置全局数据源

两点通视分析(lineOfSight)