com.supermap.services.components.spi

接口 SpatialAnalystProvider

    • 方法详细资料

      • getDatasourceNames

        java.util.List<java.lang.String> getDatasourceNames()
        

        获取数据源名称列表。

        返回:
        数据源名称列表。
      • getDatasetNames

        java.util.List<java.lang.String> getDatasetNames(java.lang.String datasourceName)
        

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

        参数:
        datasourceName - 数据源的名称
        返回:
        数据集名称列表。
      • getDatasetInfo

        DatasetInfo getDatasetInfo(java.lang.String datasourceName,
                                 java.lang.String datasetName)
        

        获取数据源中指定数据集的信息。

        参数:
        datasourceName - 数据源的名称。
        datasetName - 数据集的名称
        返回:
        数据集的信息。
      • deleteDataset

        boolean deleteDataset(java.lang.String datasourceName,
                            java.lang.String datasetName)
        

        删除分析后创建的结果数据集。

        参数:
        datasourceName - 分析结果数据集所在的数据源的名称。
        datasetName - 分析结果数据集的名称。
        返回:
        删除成功则返回true,否则返回false。
      • buffer

        DatasetSpatialAnalystResult buffer(java.lang.String dataset,
                                         QueryParameter filterQueryParameter,
                                         BufferAnalystParameter bufferAnalystParameter,
                                         BufferResultSetting setting)
        

        根据数据集创建缓冲区。

        参数:
        dataset - 数据集标识。
        filterQueryParameter - 过滤参数,可选。设置了过滤参数后,只对数据集中满足此过滤条件的对象创建缓冲区。
        bufferAnalystParameter - 缓冲区分析参数,必设参数。指定缓冲距离、缓冲区端点类型等缓冲区分析需要的信息,请参见 BufferAnalystParameter 类。
        setting - 缓冲区分析结果设置。
        返回:
        Buffer分析结果。
      • erase

        DatasetSpatialAnalystResult erase(java.lang.String sourceDataset,
                                        QueryParameter sourceDatasetFilter,
                                        java.lang.String operateDataset,
                                        QueryParameter operateDatasetFilter,
                                        DatasetOverlayResultSetting resultSetting)
        

        对两个数据集进行擦除操作。

        参数:
        sourceDataset - 被擦除的数据集(也称第一数据集)标识。该数据集类型可以是点、线和面。
        sourceDatasetFilter - 第一数据集过滤查询参数,可以为null
        operateDataset - 用于擦除的数据集(也称第二数据集)标识。该数据集类型必须是面
        operateDatasetFilter - 第二数据集过滤查询参数,可以为null。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        擦除分析结果。
      • erase

        DatasetSpatialAnalystResult erase(java.lang.String sourceDataset,
                                        QueryParameter sourceDatasetFilter,
                                        Geometry[] operateGeometries,
                                        DatasetOverlayResultSetting resultSetting)
        

        用面对象对数据集进行擦除操作,用于实现数据集和几何对象之间的叠加分析。

        参数:
        sourceDataset - 被擦除的数据集(也称第一数据集)标识。该数据集类型可以是点、线和面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateGeometries - 用于擦除的数据集(也称第二数据集)标识,该数据集类型必须是面。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • identity

        DatasetSpatialAnalystResult identity(java.lang.String sourceDataset,
                                           QueryParameter sourceDatasetFilter,
                                           java.lang.String operateDataset,
                                           QueryParameter operateDatasetFilter,
                                           DatasetOverlayResultSetting resultSetting)
        

        用于对数据集进行同一方式的叠加分析,结果数据集中保留被操作数据集的全部对象和两数据集相交的对象。

        参数:
        sourceDataset - 被操作的数据集(也称第一数据集)标识。该数据集类型可以是点、线和面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateDataset - 操作数据集(也称第二数据集)标识,该数据集类型必须是面。
        operateDatasetFilter - 过滤查询参数,可以为null。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • identity

        DatasetSpatialAnalystResult identity(java.lang.String sourceDataset,
                                           QueryParameter sourceDatasetFilter,
                                           Geometry[] operateGeometries,
                                           DatasetOverlayResultSetting resultSetting)
        

        用面对象对数据集进行同一操作,用于实现数据集和几何对象之间的叠加分析。

        参数:
        sourceDataset - 被操作的数据集(也称第一数据集)标识,该数据集类型可以是点、线和面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateGeometries - 用于操作的数据集(也称第二数据集)标识,该数据集类型必须是面。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • intersect

        DatasetSpatialAnalystResult intersect(java.lang.String sourceDataset,
                                            QueryParameter sourceDatasetFilter,
                                            java.lang.String operateDataset,
                                            QueryParameter operateDatasetFilter,
                                            DatasetOverlayResultSetting resultSetting)
        

        用于对数据集进行相交方式的叠加分析,结果数据集中保留两数据集相交的对象。

        参数:
        sourceDataset - 被操作的数据集(也称第一数据集)标识。该数据集类型可以是点、线和面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateDataset - 操作数据集(也称第二数据集)标识,该数据集类型必须是面。
        operateDatasetFilter - 过滤查询参数,可以为null。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • intersect

        DatasetSpatialAnalystResult intersect(java.lang.String sourceDataset,
                                            QueryParameter sourceDatasetFilter,
                                            Geometry[] operateGeometries,
                                            DatasetOverlayResultSetting resultSetting)
        

        用于对数据集和几何对象进行相交方式的叠加分析,结果数据集中保留数据集与几何对象相交的对象。

        参数:
        sourceDataset - 被操作的数据集(也称第一数据集)标识,该数据集类型可以是点、线和面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateGeometries - 用于操作的数据集(也称第二数据集)标识,该数据集类型必须是面。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • union

        DatasetSpatialAnalystResult union(java.lang.String sourceDataset,
                                        QueryParameter sourceDatasetFilter,
                                        java.lang.String operateDataset,
                                        QueryParameter operateDatasetFilter,
                                        DatasetOverlayResultSetting resultSetting)
        

        用于对两个面数据集进行合并方式的叠加分析,结果数据集中保存被合并叠加分析的数据集和用于合并叠加分析的数据集中的全部对象,并且对相交部分进行求交和分割运算。

        参数:
        sourceDataset - 被操作的数据集,该数据集类型必须是面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateDataset - 操作数据集(也称第二数据集)标识,该数据集类型必须是面。
        operateDatasetFilter - 过滤查询参数,可以为null。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • union

        DatasetSpatialAnalystResult union(java.lang.String sourceDataset,
                                        QueryParameter sourceDatasetFilter,
                                        Geometry[] operateGeometries,
                                        DatasetOverlayResultSetting resultSetting)
        

        用于面几何对象对数据集进行合并方式的叠加分析,结果数据集中保存被合并叠加分析的数据集和用于合并叠加分析的几何对象中的全部对象,并且对相交部分进行求交和分割运算。

        参数:
        sourceDataset - 被操作的数据集,该数据集类型必须是面。
        sourceDatasetFilter - 元数据集过滤器。
        operateGeometries - 操作几何对象。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果。
      • union

        GeometrySpatialAnalystResult union(Geometry sourceGeometry,
                                         Geometry operateGeometry,
                                         GeometrySpatialAnalystResultSetting resultSetting)
        

        用于对两个面几何对象进行合并方式的叠加分析,结果中保存被合并叠加分析的几何对象和用于合并叠加分析的几何对象中的全部对象,并且对相交部分进行求交和分割运算。

        指定者:
        union 在接口中 GeometrySpatialAnalyst
        参数:
        sourceGeometry - 被操作的几何对象,只能是面类型。
        operateGeometry - 用于同一操作的几何对象,只能是面类型。
        resultSetting - 几何对象叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与被操作几何对象相同。
      • update

        DatasetSpatialAnalystResult update(java.lang.String sourceDataset,
                                         QueryParameter sourceDatasetFilter,
                                         java.lang.String operateDataset,
                                         QueryParameter operateDatasetFilter,
                                         DatasetOverlayResultSetting resultSetting)
        

        用于对两个面数据集进行更新方式的叠加分析, 更新运算是用操作数据集替换其与源数据集的重合部分,是一个先擦除后粘贴的过程。

        参数:
        sourceDataset - 被操作的数据集,该数据集类型必须是面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateDataset - 操作数据集(也称第二数据集)标识,该数据集类型必须是面。
        operateDatasetFilter - 过滤查询参数,可以为null。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • update

        DatasetSpatialAnalystResult update(java.lang.String sourceDataset,
                                         QueryParameter sourceDatasetFilter,
                                         Geometry[] operateGeometries,
                                         DatasetOverlayResultSetting resultSetting)
        

        用于面几何对象对数据集进行更新方式的叠加分析,实现数据集和面几何对象之间的叠加分析。

        参数:
        sourceDataset - 被操作的数据集,该数据集类型必须是面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateGeometries - 操作几何对象,只能是面类型。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果,其属性表结构与被操作几何对象相同。
      • update

        GeometrySpatialAnalystResult update(Geometry sourceGeometry,
                                          Geometry operateGeometry,
                                          GeometrySpatialAnalystResultSetting resultSetting)
        

        用于对两个面几何对象进行的更新操作,实现几何对象之间的叠加分析。

        指定者:
        update 在接口中 GeometrySpatialAnalyst
        参数:
        sourceGeometry - 被操作的几何对象,只能是面类型。
        operateGeometry - 用于同一操作的几何对象,只能是面类型。
        resultSetting - 几何对象叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与被操作几何对象相同。
      • clip

        DatasetSpatialAnalystResult clip(java.lang.String sourceDataset,
                                       QueryParameter sourceDatasetFilter,
                                       java.lang.String operateDataset,
                                       QueryParameter operateDatasetFilter,
                                       DatasetOverlayResultSetting resultSetting)
        

        对两个数据集进行裁剪操作。

        参数:
        sourceDataset - 被裁剪的数据集(也称第一数据集)标识,该数据集类型可以是点、线和面。
        sourceDatasetFilter - 第一数据集过滤查询参数,可以为null。
        operateDataset - 用于裁剪的数据集(也称第二数据集)标识,该数据集类型必须是面。
        operateDatasetFilter - 第二数据集过滤查询参数,可以为null。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • clip

        DatasetSpatialAnalystResult clip(java.lang.String sourceDataset,
                                       QueryParameter sourceDatasetFilter,
                                       Geometry[] operateGeometries,
                                       DatasetOverlayResultSetting resultSetting)
        

        使用指定的面对象对数据集进行裁剪操作。

        参数:
        sourceDataset - 被裁剪的数据集(也称第一数据集)标识。该数据集类型可以是点、线和面。
        sourceDatasetFilter - 第一数据集过滤查询参数,可以为null。
        operateGeometries - 用于裁剪的面对象数组。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • xor

        DatasetSpatialAnalystResult xor(java.lang.String sourceDataset,
                                      QueryParameter sourceDatasetFilter,
                                      java.lang.String operateDataset,
                                      QueryParameter operateDatasetFilter,
                                      DatasetOverlayResultSetting resultSetting)
        

        对两个面数据集进行对称差分析运算,即交集取反运算,实现两个数据集之间的叠加分析。

        参数:
        sourceDataset - 被操作的数据集,该数据集类型必须是面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateDataset - 操作数据集标识,该数据集类型必须是面。
        operateDatasetFilter - 过滤查询参数,可以为null。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果数据集,其属性表结构与源数据集相同。
      • xor

        DatasetSpatialAnalystResult xor(java.lang.String sourceDataset,
                                      QueryParameter sourceDatasetFilter,
                                      Geometry[] operateGeometries,
                                      DatasetOverlayResultSetting resultSetting)
        

        用于面几何对象对数据集进行对称差分析运算,即交集取反运算,实现数据集与几何对象之间的叠加分析。

        参数:
        sourceDataset - 被操作的数据集,该数据集类型必须是面。
        sourceDatasetFilter - 源数据集过滤查询参数,可以为null。
        operateGeometries - 操作几何对象,只能是面类型。
        resultSetting - 数据集叠加分析结果设置。
        返回:
        返回叠加分析结果,其属性表结构与被操作几何对象相同。
      • extractIsoline

        DatasetSpatialAnalystResult extractIsoline(java.lang.String pointDataset,
                                                 QueryParameter filterQueryParameter,
                                                 java.lang.String zValueField,
                                                 double resolution,
                                                 ExtractParameter parameter,
                                                 DataReturnOption resultSetting)
        

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

        参数:
        pointDataset - 进行分析的点数据集标识(datasetName@datasourceName)。
        zValueField - 高程字段名。
        resolution - 中间结果(栅格数据集)的分辨率。
        parameter - 提取等值线的参数,必设参数。设置光滑度,重采样距离等,请参见 ExtractParameter 类。
        返回:
        根据表面分析结果设置返回相应的信息。
      • extractIsoline

        DatasetSpatialAnalystResult extractIsoline(java.lang.String pointDataset,
                                                 QueryParameter filterQueryParameter,
                                                 java.lang.String zValueField,
                                                 double resolution,
                                                 ExtractParameter parameter,
                                                 DataReturnOption resultSetting,
                                                 InterpolateType terrainInterpolateType)
        

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

        参数:
        pointDataset - 进行分析的点数据集标识(datasetName@datasourceName)。
        zValueField - 高程字段名。
        resolution - 中间结果(栅格数据集)的分辨率。
        parameter - 提取等值线的参数,必设参数。设置光滑度,重采样距离等,请参见 ExtractParameter 类。
        terrainInterpolateType - 插值分析方法
        返回:
        根据表面分析结果设置返回相应的信息。
      • extractIsoline

        DatasetSpatialAnalystResult extractIsoline(java.lang.String gridDataset,
                                                 ExtractParameter parameter,
                                                 DataReturnOption resultSetting)
        

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

        参数:
        gridDataset - 仅需分析的栅格数据集标识。
        parameter - 提取等值线的参数,必设参数。设置光滑度,重采样距离等,请参见 ExtractParameter 类。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等
        返回:
        根据表面分析结果设置返回相应的信息。
      • extractIsoline

        DatasetSpatialAnalystResult extractIsoline(Point2D[] points,
                                                 double[] zValues,
                                                 double resolution,
                                                 ExtractParameter parameter,
                                                 DataReturnOption resultSetting)
        

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

        参数:
        points - 进行分析的点数组。
        zValues - 各点的高程值数组,该数组长度必须与points相同。
        resolution - 中间结果(栅格数据集)的分辨率。
        parameter - 表面分析参数对象,请参见 ExtractParameter类。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        返回:
        根据表面分析结果设置返回相应的信息。
      • extractIsoline

        DatasetSpatialAnalystResult extractIsoline(Point2D[] points,
                                                 double[] zValues,
                                                 double resolution,
                                                 ExtractParameter parameter,
                                                 DataReturnOption resultSetting,
                                                 InterpolateType terrainInterpolateType)
        

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

        参数:
        points - 进行分析的点数组。
        zValues - 各点的高程值数组,该数组长度必须与points相同。
        resolution - 中间结果(栅格数据集)的分辨率。
        parameter - 表面分析参数对象,请参见 ExtractParameter类。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        terrainInterpolateType - 插值分析方法
        返回:
        根据表面分析结果设置返回相应的信息。
      • extractIsoregion

        DatasetSpatialAnalystResult extractIsoregion(java.lang.String pointDataset,
                                                   QueryParameter filterQueryParameter,
                                                   java.lang.String zValueField,
                                                   double resolution,
                                                   ExtractParameter parameter,
                                                   DataReturnOption resultSetting,
                                                   InterpolateType terrainInterpolateType)
        

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

        参数:
        pointDataset - 进行分析的点数据集标识(datasetName@datasourceName)。
        zValueField - 高程字段名。
        resolution - 中间结果(栅格数据集)的分辨率。
        parameter - 提取等值面的参数,必设参数。设置光滑度,重采样距离等,请参见 ExtractParameter 类。
        terrainInterpolateType - 插值分析方法
        返回:
        根据表面分析结果设置返回相应的信息。
      • extractIsoregion

        DatasetSpatialAnalystResult extractIsoregion(java.lang.String pointDataset,
                                                   QueryParameter filterQueryParameter,
                                                   java.lang.String zValueField,
                                                   double resolution,
                                                   ExtractParameter parameter,
                                                   DataReturnOption resultSetting)
        

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

        参数:
        pointDataset - 进行分析的点数据集标识(datasetName@datasourceName)。
        zValueField - 高程字段名。
        resolution - 中间结果(栅格数据集)的分辨率。
        parameter - 提取等值面的参数,必设参数。设置光滑度,重采样距离等,请参见 ExtractParameter 类。
        返回:
        根据表面分析结果设置返回相应的信息。
      • extractIsoregion

        DatasetSpatialAnalystResult extractIsoregion(java.lang.String gridDataset,
                                                   ExtractParameter parameter,
                                                   DataReturnOption resultSetting)
        

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

        参数:
        gridDataset - 仅需分析的栅格数据集标识。
        parameter - 提取等值面的参数,必设参数。设置光滑度,重采样距离等,请参见 ExtractParameter 类。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        返回:
        根据表面分析结果设置返回相应的信息。
      • extractIsoregion

        DatasetSpatialAnalystResult extractIsoregion(Point2D[] points,
                                                   double[] zValues,
                                                   double resolution,
                                                   ExtractParameter parameter,
                                                   DataReturnOption resultSetting)
        

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

        参数:
        points - 进行分析的点数组。
        zValues - 各点的高程值数组,该数组长度必须与points相同。
        resolution - 中间结果(栅格数据集)的分辨率。
        parameter - 表面分析参数对象,请参见 ExtractParameter类。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        返回:
        根据表面分析结果设置返回相应的信息。
      • extractIsoregion

        DatasetSpatialAnalystResult extractIsoregion(Point2D[] points,
                                                   double[] zValues,
                                                   double resolution,
                                                   ExtractParameter parameter,
                                                   DataReturnOption resultSetting,
                                                   InterpolateType terrainInterpolateType)
        

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

        参数:
        points - 进行分析的点数组。
        zValues - 各点的高程值数组,该数组长度必须与points相同。
        resolution - 中间结果(栅格数据集)的分辨率。
        parameter - 表面分析参数对象,请参见 ExtractParameter类。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        terrainInterpolateType - 插值分析方法
        返回:
        根据表面分析结果设置返回相应的信息。
      • interpolate

        InterpolationResult interpolate(InterpolationParameter interpolationParameter)
        

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

        参数:
        interpolationParameter - 插值参数对象,请参见 InterpolationParameter类。
        返回:
        返回插值分析得到的栅格数据集。
      • generateSpatialData

        DatasetSpatialAnalystResult generateSpatialData(GenerateSpatialDataParameter generateSpatialDataParameter,
                                                      DataReturnOption resultSetting)
        

        执行动态分段功能。

        实现动态分段的一般过程为:

        1. 准备好路由数据集和事件表
        2. 根据路由数据集和事件表重新生成动态分段结果,即一个空间数据集
        3. 由客户端对空间数据集进行展示
        参数:
        generateSpatialDataParameter - 动态分段功能的参数类。包括路由数据集名称,路由标识字段,事件表数据集名称,事件表数据集中路由标识字段,点事件表刻度字段,线事件表起止刻度字段,偏移量字段,错误信息字段。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        返回:
        动态分段结果,即一个空间数据集。
      • geoRelation

        GeoRelationResult<?>[] geoRelation(GeoRelationParameter geoRelationParameter)
        

        两个数据集间对象的空间关系分析。

        参数:
        geoRelationParameter - 空间关系分析参数。
        返回:
        空间关系分析结果数组。
      • calculateAspect

        DatasetSpatialAnalystResult calculateAspect(java.lang.String gridDataset,
                                                  TerrainAnalystSetting terrainAnalystSetting,
                                                  DataReturnOption resultSetting)
        

        计算坡向,并返回坡向栅格数据集,即坡向图。

        坡向是指坡面的朝向,它表示地形表面某处最陡的下坡方向。坡向反映了斜坡所面对的方向,任意斜坡的倾斜方向可取 0~360 度中的任意方向,所以坡向分析的结果范围为 0~360 度。从正北方向(0 度)开始顺时针计算。

        参数:
        gridDataset - 坡向分析的栅格数据集标识。
        terrainAnalystSetting - 地形分析基本环境设置。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        返回:
        返回坡向分析结果信息。
      • calculateCurvature

        java.util.List<DatasetSpatialAnalystResult> calculateCurvature(java.lang.String gridDataset,
                                                                     double zFactor,
                                                                     java.lang.String profileCurvatureName,
                                                                     java.lang.String planCurvatureName,
                                                                     DataReturnOption resultSetting)
        

        计算曲率。

        参数:
        gridDataset - 坡度分析的栅格数据集标识。
        zFactor - 指定的高程缩放系数。高程缩放系数,是指在栅格数据中,Z 坐标相对于 X 和 Y 坐标的单位变换系数。通常有 X,Y,Z 都参加的计算中,需要设置一个高程缩放系统来使其单位统一,默认值为 1.0 。
        profileCurvatureName - 输出剖面曲率数据集的名称。
        planCurvatureName - 输出平面曲率数据集的名称。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        返回:
        返回曲率计算结果信息。
      • calculateSlope

        DatasetSpatialAnalystResult calculateSlope(java.lang.String gridDataset,
                                                 TerrainAnalystSetting terrainAnalystSetting,
                                                 SlopeType slopeType,
                                                 double zFactor,
                                                 DataReturnOption resultSetting)
        

        计算坡度,并返回坡度栅格数据集,即坡度图。

        坡度是地表面上某一点的切面和水平面所成的夹角。在坡度图中的每个像元都有一个坡度值,值越大,表示地势越陡峭。坡度可以用角度、弧度或百分数来表示。由于计算点的坡度并无实际意义,方法计算的是栅格数据集中各像元平面的坡度的平均值,坡度分析结果范围为 0~90 度。

        参数:
        gridDataset - 坡度分析的栅格数据集标识。
        terrainAnalystSetting - 地形分析基本环境设置。。
        slopeType - 指定的坡度的单位类型。默认为角度 DEGREE 。
        zFactor - 指定的高程缩放系数。高程缩放系数,是指在栅格数据中,Z 坐标相对于 X 和 Y 坐标的单位变换系数。通常有 X,Y,Z 都参加的计算中,需要设置一个高程缩放系统来使其单位统一,默认值为 1.0 。
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        返回:
        返回坡度分析结果信息。
      • computeSurfaceArea

        double computeSurfaceArea(java.lang.String gridDataset,
                                Geometry region)
        

        计算表面面积,即计算指定多边形区域内的栅格数据集拟合的三维曲面的表面面积。

        参数:
        gridDataset - 计算表面积所使用的栅格数据集标识。
        region - 用于计算表面面积的多边形。
        返回:
        表面面积计算结果。
      • computeSurfaceDistance

        double computeSurfaceDistance(java.lang.String gridDataset,
                                    Geometry line)
        

        计算表面距离,即计算在栅格数据集拟合的三维曲面上沿指定的线段或折线段的曲面距离。

        参数:
        gridDataset - 计算表面积所使用的栅格数据集标识。
        line - 用于计算表面距离的二维线。
        返回:
        表面距离计算结果。
      • calculateProfile

        ProfileResult calculateProfile(java.lang.String gridDataset,
                                     Geometry line,
                                     double resampleTolerance)
        

        对栅格数据集进行剖面分析。

        参数:
        gridDataset - 指定的待进行剖面分析的栅格数据集。
        line - 指定的表示计算剖面所经历的起止范围,为一条线段或折线。
        resampleTolerance - 指定的重采样容限。
        返回:
        剖面分析结果。
      • calculateProfile

        ProfileResult calculateProfile(java.lang.String gridDataset,
                                     java.lang.String lineDataset,
                                     double resampleTolerance)
        

        对栅格数据集进行剖面分析。

        参数:
        gridDataset - 指定的待进行剖面分析的栅格数据集。
        lineDataset - 指定的表示用于计算剖面的数据集,为一线数据集。
        resampleTolerance - 指定的重采样容限。
        返回:
        剖面分析结果。
      • calculatePlumbProfile

        DatasetSpatialAnalystResult calculatePlumbProfile(Point2D startPoint,
                                                        Point2D endPoint,
                                                        java.lang.String[] modelDatasets,
                                                        java.lang.String surfaceGrid,
                                                        boolean returnDatasetOrRecordset)
        

        根据指定的剖面线对地形或模型进行剖面分析

        参数:
        startPoint - 指定的切割线的起点
        endPoint - 指定的切割线的终点
        modelDatasets - 指定的模型数据集集合。可选,但要求至少指定一个表面栅格数据集或一个模型数据集
        surfaceGrid - 指定的表面栅格数据集。可选,但要求至少指定一个表面栅格数据集或一个模型数据集。
        returnDatasetOrRecordset - 返回数据集还是记录集 ,默认返回记录集。
        返回:
        从以下版本开始:
        7.0.0
      • costPathLine

        CostPathLineResult costPathLine(java.lang.String gridDataset,
                                      Point2D sourcePoint,
                                      Point2D targetPoint,
                                      SmoothMethod smoothMethod,
                                      int smoothDegree,
                                      DataReturnOption resultSetting,
                                      double maxUpslopeDegree,
                                      double maxDownslopeDegree)
        

        栅格最短路径分析。

        根据给定的参数,进行距离栅格最短路径分析,该方法用于计算指定源和目标点之间的最少耗费线路。

        参数:
        sourcePoint - 指定的源点。
        targetPoint - 指定的目标点。
        gridDataset - 指定的耗费数据集。为栅格数据集,该数据集中每个像元的值表示途经此像元的耗费值。
        smoothMethod - 指定的对最少耗费路径进行光滑处理所使用的光滑方式。
        smoothDegree - 指定的光滑度。(1 表示不进行光滑处理,数字越大光滑度越高,但效率也会降低,建议设置范围[1,3])
        resultSetting - 返回值设置参数,设置是否返回记录、是否创建结果数据集等。
        maxUpslopeDegree - 计算两点(源和目标)间最短路径时的最大上坡角度。
        maxDownslopeDegree - 计算两点(源和目标)间最短路径时的最大下坡角度。
        返回:
        最短耗费路径结果。
      • cutFill

        CutFillResult cutFill(java.lang.String gridDataset,
                            java.lang.String afterCutFillDataset,
                            java.lang.String resultDataset,
                            boolean deleteExistResultDataset,
                            boolean buildPyramid)
        

        栅格填挖方计算。

        地表经常由于沉积和侵蚀等作用引起表面物质的迁移,某些区域的表面物质增加,某些区域的表面物质减少。在工程中,通常将表面物质的减少称为“挖方”,而将表面物质的增加称为“填方”。 栅格填挖方计算要求输入两个栅格数据集:填挖方前的栅格数据集和填挖方后的栅格数据集,生成的结果数据集的每个像元值为其两个输入数据集对应像元值的变化值。如果像元值为正,表示该像元处的表面物质减少;如果像元值为负,表示该像元处的表面物质增加。 使用栅格填挖方计算时要求两个输入的栅格数据集有相同的坐标和投影系统,以保证同一个地点有相同的坐标,如果两个输入的栅格数据集的坐标系统不一致,则很有可能产生错误的结果。理论上,要求输入的两个栅格数据集的空间范围也是一致的。对于空间范围不一致的两个栅格数据集,只计算其重叠区域的表面填挖方的结果。在其中一个栅格数据集的像元为空值处,计算结果数据集该像元值也为空值。

        参数:
        gridDataset - 用于填挖方计算的原始栅格数据集。
        afterCutFillDataset - 填挖方后的栅格数据集。
        resultDataset - 填挖方计算后的结果数据集。
        deleteExistResultDataset - 如果用户命名的结果数据集名称与已有的数据集重名,是否删除已有的数据集。
        buildPyramid - 是否对结果栅格数据集创建金字塔。
        返回:
        填挖方计算结果。
      • cutFill

        CutFillResult cutFill(java.lang.String gridDataset,
                            Geometry region,
                            double baseAltitude,
                            java.lang.String resultDataset,
                            boolean deleteExistResultDataset,
                            boolean buildPyramid)
        

        选面填挖方。

        当需要将一个高低起伏的区域夷为平地时,用户可以通过指定高低起伏的区域以及夷为平地的高程,进行选面填挖方计算,计算出填方面积,挖方面积、 填方量以及挖方量。

        参数:
        gridDataset - 用于填挖方计算的原始栅格数据集。
        region - 填挖方区域。
        baseAltitude - 指定填挖方区域的结果高程。
        resultDataset - 填挖方计算后的结果数据集。
        deleteExistResultDataset - 如果用户命名的结果数据集名称与已有的数据集重名,是否删除已有的数据集。
        buildPyramid - 是否对结果栅格数据集创建金字塔。
        返回:
        填挖方计算结果。
      • cutFill

        CutFillResult cutFill(java.lang.String gridDataset,
                            Geometry line3D,
                            double bufferRadius,
                            boolean isRoundHead,
                            java.lang.String resultDataset,
                            boolean deleteExistResultDataset,
                            boolean buildPyramid)
        

        斜面填挖方。

        斜面填挖方功能是统计在一个地形表面创建一个斜面所需要的填挖量。其原理与选面填挖方相似,通过指定填挖方路线以及在填挖方路线上的缓冲半径计算构建这个斜面所需的填方面积,挖方面积、 填方量以及挖方量。

        参数:
        gridDataset - 用于填挖方计算的原始栅格数据集。
        line3D - 填挖方路线。
        bufferRadius - 填挖方线路的缓冲区半径。
        isRoundHead - 是否使用圆头缓冲为填挖方路线创建缓冲区。
        resultDataset - 填挖方计算后的结果数据集。
        deleteExistResultDataset - 如果用户命名的结果数据集名称与已有的数据集重名,是否删除已有的数据集。
        buildPyramid - 是否对结果栅格数据集创建金字塔。
        返回:
        填挖方计算结果。
      • cutFill

        CutFillResult cutFill(java.lang.String gridDataset,
                            Geometry3D region3D,
                            java.lang.String resultDataset,
                            boolean deleteExistResultDataset,
                            boolean buildPyramid)
        

        三维面填挖方。

        一个高低起伏的区域,可以根据这个区域填挖方后的三维面,利用三维面填挖方计算出需要填方的面积,挖方的面积、填方量以及挖方量。

        参数:
        gridDataset用于填挖方计算的原始栅格数据集。 -
        region3D指定的三维面对象。 -
        resultDataset填挖方计算后的结果数据集。 -
        deleteExistResultDataset如果用户命名的结果数据集名称与已有的数据集重名,是否删除已有的数据集。 -
        buildPyramid是否对结果栅格数据集创建金字塔。 -
        返回:
        填挖方计算结果。
      • cutFill

        double cutFill(java.lang.String gridDataset,
                     double volume,
                     boolean isFill,
                     Geometry validRegion)
        

        反算填挖方。

        反算填挖方,即根据给定的填方或挖方的体积计算填挖后的高程。

        参数:
        gridDataset - 指定的待填挖的栅格数据。
        volume - 指定的填或挖的体积。该值为一个大于0的值,如果设置为小于或等于0会抛出异常。
        isFill - 指定是否进行填方计算。如果为 true 表示进行填方计算,false 表示进行挖方计算。
        validRegion - 指定的有效计算区域。指定该区域后,只在该区域内进行填方或挖方,如果该参数为空,则在整个栅格数据集范围内计算。
        返回:
        填挖后的高程值。
      • flood

        GeometrySpatialAnalystResult flood(java.lang.String gridDataset,
                                         double floodHeigth,
                                         Geometry validRegion)
        

        根据指定高度计算淹没区域。

        淹没区域的计算基于 DEM 栅格数据,凡是高程低于给定水位高程的单元格,均被划入淹没区域,然后将淹没区域转为矢量面输出,源 DEM 数据并不会被改变。通过淹没区域面对象,很容易统计出被淹没的范围、面积等。

        参数:
        gridDataset - 指定的需要计算淹没区域的 DEM 数据。
        floodHeigth - 指定的淹没的高度,即淹没后水位的高程值。
        validRegion - 指定的有效计算区域。指定该区域后,只在该区域内计算淹没区域。
        返回:
        淹没分析计算结果。
      • extractValleyLine

        DatasetSpatialAnalystResult extractValleyLine(java.lang.String gridDataset,
                                                    Geometry extractRegion,
                                                    java.lang.String targetDatasource,
                                                    java.lang.String resultGridName,
                                                    boolean deleteExistResultDataset)
        

        提取山谷线。

        参数:
        gridDataset - 指定的需要提取山谷线的 DEM 数据。
        targetDatasource - 指定的用于存储结果数据集的数据源。如果设置为 null,则结果数据集将自动存储到 surfaceGrid所在的数据源中。
        resultGridName - 指定的结果数据集的名称。
        deleteExistResultDataset - 是否删除已存在的结果数据集。
        返回:
        分析计算结果。
      • extractRidgeLine

        DatasetSpatialAnalystResult extractRidgeLine(java.lang.String gridDataset,
                                                   Geometry extractRegion,
                                                   java.lang.String targetDatasource,
                                                   java.lang.String resultGridName,
                                                   boolean deleteExistResultDataset)
        

        提取山脊线。

        参数:
        gridDataset - 指定的需要提取山脊线的 DEM 数据。
        targetDatasource - 指定的用于存储结果数据集的数据源。如果设置为 null,则结果数据集将自动存储到 surfaceGrid所在的数据源中。
        resultGridName - 指定的结果数据集的名称。
        deleteExistResultDataset - 是否删除已存在的结果数据集。
        返回:
        分析计算结果。
      • executeMathAnalystExpression

        DatasetSpatialAnalystResult executeMathAnalystExpression(java.lang.String expression,
                                                               Geometry extractRegion,
                                                               boolean isZip,
                                                               boolean ignoreNoValue,
                                                               java.lang.String targetDatasource,
                                                               java.lang.String resultGridName,
                                                               boolean deleteExistResultDataset)
        

        执行栅格代数运算表达式。

        参数:
        expression - 自定义的栅格运算表达式。
        extractRegion - 用户指定的有效计算区域。如果为 null,则表示计算全部区域,如果参与运算的数据集范围不一致,将使用所有数据集的范围的交集作为计算区域。
        isZip - 是否对结果数据集进行压缩处理。true 表示压缩。
        ignoreNoValue - 是否忽略无值栅格数据。true 表示忽略无值数据,即无值栅格不参与运算。
        targetDatasource - 指定的存储结果数据集的数据源。
        resultGridName - 指定的结果数据集。
        deleteExistResultDataset - 是否删除已存在的结果数据集
        返回:
        分析计算结果。
      • locatePoint

        GeometrySpatialAnalystResult locatePoint(Route sourceRoute,
                                               double measure,
                                               double offset,
                                               boolean isIgnoreGap)
        

        获取路由对象指定 M 值处的点对象。

        参数:
        sourceRoute - 路由对象。
        measure - 指定的 M 值。
        offset - 结果点的偏移量。
        isIgnoreGap - 是否忽略子对象之间的距离。
        返回:
        指定 M 值处的点对象。
      • locatePoint

        GeometrySpatialAnalystResult locatePoint(java.lang.String datasetName,
                                               java.lang.String routeIDField,
                                               java.lang.String routeID,
                                               double measure,
                                               double offset,
                                               boolean isIgnoreGap)
        

        获取路由对象指定 M 值处的点对象。

        参数:
        datasetName - 数据集名称。
        routeIDField - 路由标识字段。
        routeID - 路由对象标识。
        measure - 指定的 M 值。
        offset - 结果点的偏移量。
        isIgnoreGap - 是否忽略子对象之间的距离。
        返回:
        指定 M 值处的点对象。
      • locateLine

        GeometrySpatialAnalystResult locateLine(Route sourceRoute,
                                              double startMeasure,
                                              double endMeasure)
        

        获取路由对象指定起始 M 值和终止 M 值对应的线对象。

        参数:
        sourceRoute - 路由对象。
        startMeasure - 指定的起始 M 值。
        endMeasure - 指定的终止 M 值。
        返回:
        指定起始 M 值和终止 M 值对应的线对象。
      • locateLine

        GeometrySpatialAnalystResult locateLine(java.lang.String datasetName,
                                              java.lang.String routeIDField,
                                              java.lang.String routeID,
                                              double startMeasure,
                                              double endMeasure)
        

        获取路由对象指定起始 M 值和终止 M 值对应的线对象。

        参数:
        datasetName - 数据集名称。
        routeIDField - 路由标识字段。
        routeID - 路由对象标识。
        startMeasure - 指定的起始 M 值。
        endMeasure - 指定的终止 M 值。
        返回:
        指定起始 M 值和终止 M 值对应的线对象。
      • calculateMeasureAtPoint

        RouteCalculateMeasureResult calculateMeasureAtPoint(Route sourceRoute,
                                                          Point2D point,
                                                          double tolerance,
                                                          boolean isIgnoreGap)
        

        计算路由对象指定点对象处的 M 值。

        参数:
        sourceRoute - 路由对象。
        point - 指定的点对象。
        tolerance - 容限值。
        isIgnoreGap - 是否忽略子对象之间的距离。
        返回:
        指定点对象处的 M 值计算结果。
      • kernelDensity

        DatasetSpatialAnalystResult kernelDensity(DensityAnalystParameterInput inputParam,
                                                java.lang.String sourceDatasetTag,
                                                java.lang.String fieldName,
                                                java.lang.String targetDatasource,
                                                java.lang.String resultGridName,
                                                boolean deleteExistResultDataset)
        

        对点数据集或线数据集进行核密度分析,并返回核密度分析得到的栅格数据集。

        参数:
        inputParam - 核密度分析需要的参数。
        sourceDatasetTag - 进行核密度分析的点数据集或线数据集标识(datasetName@datasourceName)。
        fieldName - 用于进行密度分析的测量值的字段名称。密度分析不支持文本类型的字段。
        targetDatasource - 指定的存储结果数据集的数据源。
        resultGridName - 指定的结果数据集。
        deleteExistResultDataset - 是否删除已存在的结果数据集。
        返回:
        核密度分析结果。