C# Class SuperMap.Connector.SpatialAnalyst

SpatialAnalyst 组件接口，用以访问 SuperMap iServer 空间分析服务组件中的REST服务，封装了与空间分析相关的一系列功能。

只能针对 SuperMap iServer REST 接口类型服务的访问。实例化SpatialAnalyst对象时需要使用明确的空间分析服务组件地址(例如：http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr")

Show file Open project: SuperMap/iClient-for-DotNet

Public Methods

Method	Description
Buffer ( string datasetName, BufferAnalystParameter bufferAnalystParameter, QueryParameter filterQueryParameter, BufferResultSetting bufferResultSetting ) : DatasetSpatialAnalystResult	根据数据集创建缓冲区。
Buffer ( Geometry geometry, BufferAnalystParameter bufferAnalystParameter ) : GeometrySpatialAnalystResult	根据几何对象创建缓冲区，成功则返回一个面对象，失败则返回空值。
GetDatasetInfo ( string datasourceName, string datasetName ) : DatasetInfo	获取指定数据集名的数据集信息。
GetDatasetInfos ( string datasourceName ) : List	获取指定数据源名称下数据集列表。
GetDatasourceNames ( ) : List	获取数据源名称列表。
Interpolate ( string pointDataset, InterpolationParameter parameter ) : DatasetSpatialAnalystResult	用于对离散的点数据进行插值得到栅格数据集。插值分析可以将有限的采样点数据，通过插值对采样点周围的数值情况进行预测，从而掌握研究区域内数据的总体分布状况，而使采样的离散点不仅仅反映其所在位置的数值情况，而且可以反映区域的数值分布。插值分析支持的算法类型：点密度、径向基函数、距离反比权值、普通克吕金、简单克吕金、泛克吕金共6种插值法。 (1)点密度（Density）插值法。插值分析时只需要将parameter参数定义为InterpolationDensityParameter类型，即可进行点密度插值法。 (2)径向基函数（Radial Basis Function）插值法。该方法假设变化是平滑的，它有两个特点：表面必须精确通过数据点；表面必须有最小曲率。该插值在创建有视觉要求的曲线和等高线方面有优势。插值分析时只需要将parameter参数定义为InterpolationRBFParameter类型，即可进行径向基函数插值法。 (3)距离反比权值（Inverse Distance Weighted）插值法。该方法通过计算附近区域离散点群的平均值来估算单元格的值，生成格网数据集。这是一种简单有效的数据内插方法，运算速度相对较快。距离离散中心越近的点，其估算值越受影响。插值分析时只需要将parameter参数定义为InterpolationIDWParameter类型，即可进行距离反比权值插值法。 (4)克吕金插值法。克吕金插值法又分成3种类型（参考KrigingAlgorithmType）：普通克吕金插值法；简单克吕金插值法；泛克吕金插值法。插值分析时需要将parameter参数定义为InterpolationKrigingParameter类型，并且在InterpolationKrigingParameter.Type参数中设置克吕金插值法的类型，即可进行克吕金插值法。
IsoLine ( Point2D points, double zValues, double resolution, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult	用于从一个点集合中提取等值线，方法的实现原理是先利用点集合中存储的第三维信息（高程或者温度等），也就是除了点的坐标信息的数据，对点数据进行插值分析，得到栅格数据集（中间结果数据集），接着从栅格数据集中提取等值线。
IsoLine ( string gridDataset, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult	用于从栅格数据集中提取等值线。
IsoLine ( string pointDataset, QueryParameter filterQueryParameter, string zValueField, double resolution, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult	用于从点数据集中提取等值线，该方法的实现原理是先对点数据集进行插值分析，得到栅格数据集（方法实现的中间结果），接着从栅格数据集中提取等值线。
IsoRegion ( Point2D points, double zValues, double resolution, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult	用于从一个点集合中提取等值面，方法的实现原理是先利用点集合中存储的第三维信息（高程或者温度等），也就是除了点的坐标信息的数据，对点数据进行插值分析，得到栅格数据集（中间结果数据集），接着从栅格数据集中提取等值面。
IsoRegion ( string gridDataset, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult	用于从栅格数据集中提取等值面。
IsoRegion ( string pointDataset, QueryParameter filterQueryParameter, string zValueField, double resolution, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult	用于从点数据集中提取等值面，该方法的实现原理是先对点数据集进行插值分析，得到栅格数据集（方法实现的中间结果），接着从栅格数据集提取等值面。
Overlay ( string sourceDataset, Geometry operateRegions, OverlayOperationType operation ) : DatasetSpatialAnalystResult	使用指定的区域对数据集进行叠加分析操作。
Overlay ( string sourceDataset, Geometry operateRegions, OverlayOperationType operation, DatasetOverlayResultSetting datasetOverlayResultSetting ) : DatasetSpatialAnalystResult	根据指定的分析返回结果设置使用指定的区域对数据集进行叠加分析操作。
Overlay ( string sourceDataset, QueryParameter sourceDatasetFilter, Geometry operateRegions, OverlayOperationType operation, DatasetOverlayResultSetting datasetOverlayResultSetting ) : DatasetSpatialAnalystResult	根据指定的过滤条件以及返回结果设置使用指定的区域对数据集进行叠加分析操作。
Overlay ( string sourceDataset, QueryParameter sourceDatasetFilter, string operateDataset, QueryParameter operateDatasetFilter, OverlayOperationType operation, DatasetOverlayResultSetting datasetOverlayResultSetting ) : DatasetSpatialAnalystResult	根据指定的过滤条件以及分析返回结果设置对两个数据集进行叠加分析操作。在矢量数据集叠加分析中至少涉及到三个数据集，其中一个数据集被称作源数据集，即被操作的数据集（在 SuperMap GIS 中称作第一数据集）；另一个数据集被称作叠加数据集，即操作数据集（operateDataset）；还有一个数据集就是叠加结果数据集，包含叠加后数据的几何信息和属性信息。叠加结果数据集中的属性信息来自于第一数据集和第二数据集的属性表，在进行叠加分析的时候，用户可以根据自己的需要在这两个数据集的属性表中选择需要保留的属性字段。
Overlay ( string sourceDataset, string operateDataset, OverlayOperationType operation ) : DatasetSpatialAnalystResult	对两个数据集进行叠加分析操作。
Overlay ( string sourceDataset, string operateDataset, OverlayOperationType operation, DatasetOverlayResultSetting datasetOverlayResultSetting ) : DatasetSpatialAnalystResult	根据指定的分析返回结果设置对两个数据集进行叠加分析操作。
Overlay ( Geometry sourceGeometry, Geometry operateGeometry, OverlayOperationType operation ) : GeometrySpatialAnalystResult	使用几何对象进行叠加分析操作。
SpatialAnalyst ( string serviceUrl ) : System	构造函数。

Method Details

Buffer() public method

根据数据集创建缓冲区。

参数 datasetName 为空时抛出异常。服务端处理错误时抛出异常。

public Buffer ( string datasetName, BufferAnalystParameter bufferAnalystParameter, QueryParameter filterQueryParameter, BufferResultSetting bufferResultSetting ) : DatasetSpatialAnalystResult
datasetName	string	数据集标识。
bufferAnalystParameter	BufferAnalystParameter	缓冲区分析参数，必设参数。指定缓冲距离、缓冲区端点类型等缓冲区分析需要的信息，请参见类。
filterQueryParameter	SuperMap.Connector.Utility.QueryParameter	过滤参数，可选。设置了过滤参数后，只对数据集中满足此过滤条件的对象创建缓冲区。
bufferResultSetting	BufferResultSetting	数据集缓冲区分析结果设置参数。
return	DatasetSpatialAnalystResult

Buffer() public method

根据几何对象创建缓冲区，成功则返回一个面对象，失败则返回空值。

服务端处理错误时抛出异常。

public Buffer ( Geometry geometry, BufferAnalystParameter bufferAnalystParameter ) : GeometrySpatialAnalystResult
geometry	Geometry	需要创建缓冲区的几何对象。
bufferAnalystParameter	BufferAnalystParameter	缓冲区分析参数，必设参数。指定缓冲距离、缓冲区端点类型等缓冲区分析需要的信息，请参见类。
return	GeometrySpatialAnalystResult

GetDatasetInfo() public method

获取指定数据集名的数据集信息。

参数 datasourceName, datasetName 为空时抛出异常。服务端处理错误时抛出异常。

public GetDatasetInfo ( string datasourceName, string datasetName ) : DatasetInfo
datasourceName	string	数据源名。
datasetName	string	数据集名。
return	DatasetInfo

GetDatasetInfos() public method

获取指定数据源名称下数据集列表。

参数 datasourceName 为空时抛出异常。服务端处理错误时抛出异常。

public GetDatasetInfos ( string datasourceName ) : List
datasourceName	string	数据源名。
return	List

GetDatasourceNames() public method

获取数据源名称列表。

服务端处理错误时抛出异常。

public GetDatasourceNames ( ) : List
return	List

Interpolate() public method

用于对离散的点数据进行插值得到栅格数据集。插值分析可以将有限的采样点数据，通过插值对采样点周围的数值情况进行预测，从而掌握研究区域内数据的总体分布状况，而使采样的离散点不仅仅反映其所在位置的数值情况，而且可以反映区域的数值分布。

插值分析支持的算法类型：点密度、径向基函数、距离反比权值、普通克吕金、简单克吕金、泛克吕金共6种插值法。

(1)点密度（Density）插值法。插值分析时只需要将parameter参数定义为InterpolationDensityParameter类型，即可进行点密度插值法。

(2)径向基函数（Radial Basis Function）插值法。该方法假设变化是平滑的，它有两个特点：表面必须精确通过数据点；表面必须有最小曲率。该插值在创建有视觉要求的曲线和等高线方面有优势。插值分析时只需要将parameter参数定义为InterpolationRBFParameter类型，即可进行径向基函数插值法。

(3)距离反比权值（Inverse Distance Weighted）插值法。该方法通过计算附近区域离散点群的平均值来估算单元格的值，生成格网数据集。这是一种简单有效的数据内插方法，运算速度相对较快。距离离散中心越近的点，其估算值越受影响。插值分析时只需要将parameter参数定义为InterpolationIDWParameter类型，即可进行距离反比权值插值法。

(4)克吕金插值法。克吕金插值法又分成3种类型（参考KrigingAlgorithmType）：普通克吕金插值法；简单克吕金插值法；泛克吕金插值法。插值分析时需要将parameter参数定义为InterpolationKrigingParameter类型，并且在InterpolationKrigingParameter.Type参数中设置克吕金插值法的类型，即可进行克吕金插值法。

参数 parameter 为空时抛出异常。服务端处理错误时抛出异常。

public Interpolate ( string pointDataset, InterpolationParameter parameter ) : DatasetSpatialAnalystResult
pointDataset	string	进行插值分析的点数据集名称，如SamplesP@Interpolation。
parameter	InterpolationParameter	插值参数对象。
return	DatasetSpatialAnalystResult

IsoLine() public method

用于从一个点集合中提取等值线，方法的实现原理是先利用点集合中存储的第三维信息（高程或者温度等），也就是除了点的坐标信息的数据，对点数据进行插值分析，得到栅格数据集（中间结果数据集），接着从栅格数据集中提取等值线。

参数 parameter 为空时抛出异常。服务端处理错误时抛出异常。

public IsoLine ( Point2D points, double zValues, double resolution, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult
points	Point2D	进行分析的点数组。
zValues	double	各点的高程值数组，该数组长度必须与points相同。
resolution	double	中间结果（栅格数据集）的分辨率。
parameter	ExtractParameter	提取等值线的参数，必设参数。设置光滑度、重采样距离等，请参见类。
resultSetting	DataReturnOption	返回值设置参数，设置是否返回记录、是否创建结果数据集等。
return	DatasetSpatialAnalystResult

IsoLine() public method

用于从栅格数据集中提取等值线。

参数 gridDataset,parameter 为空时抛出异常。服务端处理错误时抛出异常。

public IsoLine ( string gridDataset, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult
gridDataset	string	需分析的栅格数据集标识。
parameter	ExtractParameter	提取等值线的参数，必设参数。设置光滑度、重采样距离等，请参见类。
resultSetting	DataReturnOption	返回值设置参数，设置是否返回记录、是否创建结果数据集等。
return	DatasetSpatialAnalystResult

IsoLine() public method

用于从点数据集中提取等值线，该方法的实现原理是先对点数据集进行插值分析，得到栅格数据集（方法实现的中间结果），接着从栅格数据集中提取等值线。

参数 pointDataset,parameter 为空时抛出异常。服务端处理错误时抛出异常。

public IsoLine ( string pointDataset, QueryParameter filterQueryParameter, string zValueField, double resolution, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult
pointDataset	string	进行分析的点数据集标识(datasetName@datasourceName)。
filterQueryParameter	SuperMap.Connector.Utility.QueryParameter	对点数据集中的点对象进行过滤的属性过滤条件。只有满足过滤条件的点才参与分析。
zValueField	string	高程字段名。
resolution	double	中间结果（栅格数据集）的分辨率。
parameter	ExtractParameter	提取等值线的参数，必设参数。设置光滑度、重采样距离等，请参见类。
resultSetting	DataReturnOption	返回值设置参数，设置是否返回记录、是否创建结果数据集等。
return	DatasetSpatialAnalystResult

IsoRegion() public method

用于从一个点集合中提取等值面，方法的实现原理是先利用点集合中存储的第三维信息（高程或者温度等），也就是除了点的坐标信息的数据，对点数据进行插值分析，得到栅格数据集（中间结果数据集），接着从栅格数据集中提取等值面。

参数 parameter 为空时抛出异常。服务端处理错误时抛出异常。

public IsoRegion ( Point2D points, double zValues, double resolution, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult
points	Point2D	进行分析的点数组。
zValues	double	各点的高程值数组，该数组长度必须与points相同。
resolution	double	中间结果（栅格数据集）的分辨率。
parameter	ExtractParameter	提取等值面的参数，必设参数。设置光滑度、重采样距离等，请参见类。
resultSetting	DataReturnOption	返回值设置参数，设置是否返回记录、是否创建结果数据集等。
return	DatasetSpatialAnalystResult

IsoRegion() public method

用于从栅格数据集中提取等值面。

参数 gridDataset,parameter 为空时抛出异常。服务端处理错误时抛出异常。

public IsoRegion ( string gridDataset, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult
gridDataset	string	需分析的栅格数据集标识。
parameter	ExtractParameter	提取等值面的参数，必设参数。设置光滑度、重采样距离等，请参见类。
resultSetting	DataReturnOption	返回值设置参数，设置是否返回记录、是否创建结果数据集等。
return	DatasetSpatialAnalystResult

IsoRegion() public method

用于从点数据集中提取等值面，该方法的实现原理是先对点数据集进行插值分析，得到栅格数据集（方法实现的中间结果），接着从栅格数据集提取等值面。

参数 pointDataset,parameter 为空时抛出异常。服务端处理错误时抛出异常。

public IsoRegion ( string pointDataset, QueryParameter filterQueryParameter, string zValueField, double resolution, ExtractParameter parameter, DataReturnOption resultSetting ) : DatasetSpatialAnalystResult
pointDataset	string	进行分析的点数据集标识(datasetName@datasourceName)。
filterQueryParameter	SuperMap.Connector.Utility.QueryParameter	对点数据集中的点对象进行过滤的属性过滤条件。只有满足过滤条件的点才参与分析。
zValueField	string	高程字段名。
resolution	double	中间结果（栅格数据集）的分辨率。
parameter	ExtractParameter	提取等值面的参数，必设参数。设置光滑度、重采样距离等，请参见类。
resultSetting	DataReturnOption	返回值设置参数，设置是否返回记录、是否创建结果数据集等。
return	DatasetSpatialAnalystResult

Overlay() public method

使用指定的区域对数据集进行叠加分析操作。

参数 sourceDataset, operateRegions 为空时抛出异常。服务端处理错误时抛出异常。

public Overlay ( string sourceDataset, Geometry operateRegions, OverlayOperationType operation ) : DatasetSpatialAnalystResult
sourceDataset	string	源数据集名，也即被操作数据集名，例如：region1@changchun。
operateRegions	Geometry	操作区域。
operation	OverlayOperationType	叠加分析类型，叠加操作有：裁剪（CLIP）、擦除（ERASE）、合并（UNION）、相交（INTERSECT）、同一（IDENTITY）、对称差（XOR）和更新（UPDATE）。
return	DatasetSpatialAnalystResult

Overlay() public method

根据指定的分析返回结果设置使用指定的区域对数据集进行叠加分析操作。

参数 sourceDataset, operateRegions 为空时抛出异常。服务端处理错误时抛出异常。

public Overlay ( string sourceDataset, Geometry operateRegions, OverlayOperationType operation, DatasetOverlayResultSetting datasetOverlayResultSetting ) : DatasetSpatialAnalystResult
sourceDataset	string	源数据集名，也即被操作数据集名，例如：region1@changchun。
operateRegions	Geometry	操作区域。
operation	OverlayOperationType	叠加分析类型，叠加操作有：裁剪（CLIP）、擦除（ERASE）、合并（UNION）、相交（INTERSECT）、同一（IDENTITY）、对称差（XOR）和更新（UPDATE）。
datasetOverlayResultSetting	DatasetOverlayResultSetting	数据集叠加分析结果设置。
return	DatasetSpatialAnalystResult

Overlay() public method

根据指定的过滤条件以及返回结果设置使用指定的区域对数据集进行叠加分析操作。

参数 sourceDataset, operateRegions 为空时抛出异常。服务端处理错误时抛出异常。

public Overlay ( string sourceDataset, QueryParameter sourceDatasetFilter, Geometry operateRegions, OverlayOperationType operation, DatasetOverlayResultSetting datasetOverlayResultSetting ) : DatasetSpatialAnalystResult
sourceDataset	string	源数据集名，也即被操作数据集名，例如：region1@changchun。
sourceDatasetFilter	SuperMap.Connector.Utility.QueryParameter	源数据集中空间对象过滤条件。设置完过滤条件后，源数据集中仅有满足条件的对象才参与叠加分析。
operateRegions	Geometry	操作区域。
operation	OverlayOperationType	叠加分析类型，叠加操作有：裁剪（CLIP）、擦除（ERASE）、合并（UNION）、相交（INTERSECT）、同一（IDENTITY）、对称差（XOR）和更新（UPDATE）。
datasetOverlayResultSetting	DatasetOverlayResultSetting	数据集叠加分析结果设置。
return	DatasetSpatialAnalystResult

Overlay() public method

根据指定的过滤条件以及分析返回结果设置对两个数据集进行叠加分析操作。

在矢量数据集叠加分析中至少涉及到三个数据集，其中一个数据集被称作源数据集，即被操作的数据集（在 SuperMap GIS 中称作第一数据集）；另一个数据集被称作叠加数据集，即操作数据集（operateDataset）；还有一个数据集就是叠加结果数据集，包含叠加后数据的几何信息和属性信息。叠加结果数据集中的属性信息来自于第一数据集和第二数据集的属性表，在进行叠加分析的时候，用户可以根据自己的需要在这两个数据集的属性表中选择需要保留的属性字段。

参数 sourceDataset, operateDataset 为空时抛出异常。服务端处理错误时抛出异常。

public Overlay ( string sourceDataset, QueryParameter sourceDatasetFilter, string operateDataset, QueryParameter operateDatasetFilter, OverlayOperationType operation, DatasetOverlayResultSetting datasetOverlayResultSetting ) : DatasetSpatialAnalystResult
sourceDataset	string	源数据集名，也即被操作数据集名，例如：region1@changchun。
sourceDatasetFilter	SuperMap.Connector.Utility.QueryParameter	源数据集中空间对象过滤条件。设置完过滤条件后，源数据集中仅有满足条件的对象才参与叠加分析。
operateDataset	string	操作数据集名，例如:region2@changchun。
operateDatasetFilter	SuperMap.Connector.Utility.QueryParameter	操作数据集中空间对象过滤条件。设置完过滤条件后，操作数据集中仅有满足条件的对象才参与叠加分析。
operation	OverlayOperationType	叠加分析类型，叠加操作有：裁剪（CLIP）、擦除（ERASE）、合并（UNION）、相交（INTERSECT）、同一（IDENTITY）、对称差（XOR）和更新（UPDATE）。
datasetOverlayResultSetting	DatasetOverlayResultSetting	数据集叠加分析结果设置。
return	DatasetSpatialAnalystResult

Overlay() public method

对两个数据集进行叠加分析操作。

参数 sourceDataset, operateDataset 为空时抛出异常。服务端处理错误时抛出异常。

public Overlay ( string sourceDataset, string operateDataset, OverlayOperationType operation ) : DatasetSpatialAnalystResult
sourceDataset	string	源数据集名，也即被操作数据集名，例如：region1@changchun。
operateDataset	string	操作数据集名，例如:region2@changchun。
operation	OverlayOperationType	叠加分析类型，叠加操作有：裁剪（CLIP）、擦除（ERASE）、合并（UNION）、相交（INTERSECT）、同一（IDENTITY）、对称差（XOR）和更新（UPDATE）。
return	DatasetSpatialAnalystResult

Overlay() public method

根据指定的分析返回结果设置对两个数据集进行叠加分析操作。

参数 sourceDataset, operateDataset 为空时抛出异常。服务端处理错误时抛出异常。

public Overlay ( string sourceDataset, string operateDataset, OverlayOperationType operation, DatasetOverlayResultSetting datasetOverlayResultSetting ) : DatasetSpatialAnalystResult
sourceDataset	string	源数据集名，也即被操作数据集名，例如：region1@changchun。
operateDataset	string	操作数据集名，例如:region2@changchun。
operation	OverlayOperationType	叠加分析类型，叠加操作有：裁剪（CLIP）、擦除（ERASE）、合并（UNION）、相交（INTERSECT）、同一（IDENTITY）、对称差（XOR）和更新（UPDATE）。
datasetOverlayResultSetting	DatasetOverlayResultSetting	数据集叠加分析结果设置。
return	DatasetSpatialAnalystResult

Overlay() public method

使用几何对象进行叠加分析操作。

参数 sourceGeometry, operateGeometry为空时抛出异常。服务端处理错误时抛出异常。

public Overlay ( Geometry sourceGeometry, Geometry operateGeometry, OverlayOperationType operation ) : GeometrySpatialAnalystResult
sourceGeometry	Geometry	被操作的几何对象。
operateGeometry	Geometry	操作几何对象。
operation	OverlayOperationType	叠加分析类型，叠加操作有：裁剪（CLIP）、擦除（ERASE）、合并（UNION）、相交（INTERSECT）、同一（IDENTITY）、对称差（XOR）和更新（UPDATE）。
return	GeometrySpatialAnalystResult

SpatialAnalyst() public method

构造函数。

参数 serviceUrl 为空时抛出异常。

public SpatialAnalyst ( string serviceUrl ) : System
serviceUrl	string	SuperMap iServer 空间分析服务组件的URL地址(例如：http://localhost:8090/iserver/services/transportationanalyst-sample/restjsr")。
return	System