阴影分析(shade)

POST

/rest/services/{servicename}/spatialanalysis/shade

该算法计算输入中的数字化地形模型的山体阴影。

根据太阳的位置 (方位角和高程) 计算图层的晕渲。

山体阴影通过为栅格中的每个像元确定照明度，来获取表面的假定照明度。通过设置假定光源的位置，结合栅格数据集的坡度和坡向信息，得到各像元的灰度值，面向光源的斜坡的灰度值较高，背向光源的灰度值较低，即阴影区，由此来形象的表现实际地表的地势地貌。进行分析或图形显示时，特别是使用透明度时，“山体阴影”可大大增强表面的可视化。

由于得到的山体阴影图具有三维立体的效果，因此配置晕渲图常会用到山体阴影数据。通过叠加栅格与山体阴影数据，对栅格图层进行透明度、渲染设置调整，可以轻松的创建出立体效果地貌图。在此基础上，逐渐丰富地图信息，叠加其它图层数据，比如道路、河流等，可以制作出非常精美细致的晕渲图。

使用DEM数据生成山体阴影图，返回的结果类型为栅格数据集。

Zfactor 的设置

如果z (仰角) 单位的度量单位与x、y (水平)单位相同，则z因子为1。如果度量单位不同，那么就需要定义一个z因子来解释这种差异，参见下表。

例如，当使用地理坐标系数据（例如坐标系为经纬度的GCS_WGS 84）时，高程以米（Meters）为单位，就需要将米（Meters）转为度（Degrees），则设置转换系数Zfactor为0.00001，参见下表。

From	To
	英尺（Feet）	米（Meters）	度（Degrees）
英尺（Feet）	1	0.3048	0.000003
米（Meters )	3.28084	1	0.00001

请求参数

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

azimuth

number

可选

方向角指的是太阳的角度方向，是以北为基准方向在 0 到 360 度范围内按顺时针进行测量的（以度为单位）。其值的范围为 0 到 360 之间。方位角是用来确定光源的方向，是用角度来表示的。以正北方向为0度开始，沿顺时针方向测量，从0度到360度来给各方向赋角度值，因而正北方向也是360度。正东方向为90度，正南方向为180度，正西方向为270度。

altitude

number

可选

高度角指的是照明源高出地平线的角度或坡度。高度的单位为度，范围为 0（位于地平线上）到 90（位于头上）之间。默认值为 45 度

time

string

可选

指定时刻。格式为yyyy-MM-dd hh:mm:ss 示例 2021-12-12 12:00:00

timezone

string

可选

参与输入所在的时区。默认设置是操作系统所设置的时区，国内为即东8区。

outPutType

integer

必需

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

outSRS

string

可选

生成数据集的空间参考

outDataset

object (数据集连接对象)

可选

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

aysn

boolean

可选

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

extend

object

可选

限定计算的范围，geojson格式的矩形多边形具体参见 “geojson 对象” geojson 对象。空间参考使用extendSRS参数。主要是用于数据量较大时，限定局部范围。默认采用地形数据集范围.通过范围的中心点计算维度信息。

extendSRS

string

可选

extend的空间参考,可选，默认使用地形数据集的空间参考.

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。

示例

{
    "dataset": {
        "datasourceName": "地形分析",
        "datasetName": "dem84.tif"
    },
    "azimuth":315.0,
    "altitude":45.0,
    "outSRS":"EPSG:4326",
    "outDataset":
    {
        "datasourceName": "地形分析",
        "datasetName": "dem84_shade.tif"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rest/services//spatialanalysis/shade' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dataset": {
        "datasourceName": "地形分析",
        "datasetName": "dem84.tif"
    },
    "azimuth":315.0,
    "altitude":45.0,
    "outSRS":"EPSG:4326",
    "outDataset":
    {
        "datasourceName": "地形分析",
        "datasetName": "dem84_shade.tif"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

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

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

修改于 2025-03-14 07:13:07

两点通视分析(lineOfSight)

坡度分析(slope)