com.supermap.services.components.impl

Class SpatialAnalystImpl

  • java.lang.Object
    • com.supermap.services.components.impl.SpatialAnalystImpl
  • All Implemented Interfaces:
    ComponentContextAware, SpatialAnalyst, Disposable

    public class SpatialAnalystImpl
extends java.lang.Object
implements SpatialAnalyst, Disposable, ComponentContextAware

    The implementation class of the spatial analysis service component interface.

    Spatial analysis service components are a set of GIS service components encapsulating all the GIS functions related to spatial analysis. Spatial analyst includes the buffer analysis, overlay analysis, surface analysis, etc.

    The service providers in a spatial analysis service component must be spatial analysis service providers (SpatialAnalystProvider).

    • Field Detail

      • innerImpl

        protected com.supermap.services.components.impl.SpatialAnalystImpl.InnerImpl innerImpl

    • Constructor Detail

      • SpatialAnalystImpl

        public SpatialAnalystImpl(ComponentContext context)

        The constructor. Structures the spatial analysis component object through the spatial analysis service component context.

        Parameters:
        context - The spatial analysis service component context.

      • SpatialAnalystImpl

        public SpatialAnalystImpl()

        The constructor.

    • Method Detail

      • setComponentContext

        public void setComponentContext(ComponentContext context)

        Sets the context of spatial analysis service component.

        Specified by:
        setComponentContext in interface ComponentContextAware
        Parameters:
        context - The context of spatial analysis service component.
        Since:
        7.0.0

      • dispose

        public void dispose()
        Description copied from interface: Disposable

        Release the resource object.

        Specified by:
        dispose in interface Disposable

      • getDatasourceNames

        public java.util.List<java.lang.String> getDatasourceNames()
        Description copied from interface: SpatialAnalyst

        Gets the list of datasource names.

        Specified by:
        getDatasourceNames in interface SpatialAnalyst

      • getDatasetNames

        public java.util.List<java.lang.String> getDatasetNames(java.lang.String datasourceName)
        Description copied from interface: SpatialAnalyst

        Gets the list of dataset names in a specified datasource.

        Specified by:
        getDatasetNames in interface SpatialAnalyst
        Parameters:
        datasourceName - The name of the datasource.
        Returns:
        The list of dataset names.

      • getDatasetInfo

        public DatasetInfo getDatasetInfo(java.lang.String datasourceName,
                         java.lang.String datasetName)
        Description copied from interface: SpatialAnalyst

        Gets information about a specified dataset in a datasource.

        Specified by:
        getDatasetInfo in interface SpatialAnalyst
        Parameters:
        datasourceName - The name of the datasource.
        datasetName - The dataset name.
        Returns:
        The dataset information.

      • deleteDataset

        public boolean deleteDataset(java.lang.String datasourceName,
                    java.lang.String datasetName)
        Description copied from interface: SpatialAnalyst

        Deletes the result dataset created after the analysis.

        Specified by:
        deleteDataset in interface SpatialAnalyst
        Parameters:
        datasourceName - The name of the datasource which includes the analysis results.
        datasetName - The dataset name of the analysis results.
        Returns:
        True, if successful; Otherwise false.

      • buffer

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

        Returns the result of a buffer analysis on a dataset and does not support flat buffer.

        Specified by:
        buffer in interface SpatialAnalyst
        Parameters:
        dataset - Dataset.
        filterQueryParameter - The query parameter for describing the restriction in a conditional query.
        bufferAnalystParameter - The parameters used for buffer analysis.
        setting - The buffer analysis result setting.
        Returns:
        The result of the buffer analysis on the dataset.

      • erase

        public DatasetSpatialAnalystResult erase(java.lang.String sourceDataset,
                                QueryParameter sourceDatasetFilter,
                                java.lang.String operateDataset,
                                QueryParameter operateDatasetFilter,
                                DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an erase operation on two datasets.

        Specified by:
        erase in interface SpatialAnalyst
        Parameters:
        sourceDataset - The identifier of the dataset to be erased (the first dataset). The type of this dataset can be any of the following: point, line, or region.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateDataset - The identifier of the dataset used for erasing (the second dataset). It must be the region type.
        operateDatasetFilter - The filter query parameter for the second dataset. It can be null.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The erase analysis result.

      • erase

        public DatasetSpatialAnalystResult erase(java.lang.String sourceDataset,
                                QueryParameter sourceDatasetFilter,
                                Geometry[] operateGeometries,
                                DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an erase operation on a dataset using a specified region object.

        Specified by:
        erase in interface SpatialAnalyst
        Parameters:
        sourceDataset - The identifier of the dataset to be erased (the first dataset). The type of this dataset can be any of the following: point, line, or region.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateGeometries - The array of the region objects used for to erasing.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The erase analysis result.

      • erase

        public GeometrySpatialAnalystResult erase(Geometry sourceGeometry,
                                 Geometry operateGeometry,
                                 GeometrySpatialAnalystResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an erase operation on two Geometries.

        Specified by:
        erase in interface SpatialAnalyst
        Parameters:
        sourceGeometry - The Geometry object to be erased. Its type can be point, line, or region.
        operateGeometry - The Geometry object that acts as an eraser. Its type must be region.
        resultSetting - The result setting for spatial analysis on geometric objects.
        Returns:
        The erase analysis result.

      • identity

        public DatasetSpatialAnalystResult identity(java.lang.String sourceDataset,
                                   QueryParameter sourceDatasetFilter,
                                   java.lang.String operateDataset,
                                   QueryParameter operateDatasetFilter,
                                   DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an identity operation on two datasets.

        Specified by:
        identity in interface SpatialAnalyst
        Parameters:
        sourceDataset - The identifier of the dataset to be identified (the first dataset). The type of this dataset can be any of the following: point, line, or region.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateDataset - The identifier of the dataset that is used to identify (the second dataset). The type of this dataset must be region.
        operateDatasetFilter - The filter query parameter for the second dataset. It can be null.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The identity analysis result.

      • identity

        public DatasetSpatialAnalystResult identity(java.lang.String sourceDataset,
                                   QueryParameter sourceDatasetFilter,
                                   Geometry[] operateGeometries,
                                   DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an identity operation on a dataset by using specified region objects.

        Specified by:
        identity in interface SpatialAnalyst
        Parameters:
        sourceDataset - The identifier of the dataset to be identified (the first dataset). The type of this dataset can be any of the following: point, line, or region.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateGeometries - The array of the region objects that are used to identify.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The identity analysis result.

      • identity

        public GeometrySpatialAnalystResult identity(Geometry sourceGeometry,
                                    Geometry operateGeometry,
                                    GeometrySpatialAnalystResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an identity operation on two Geometries.

        Specified by:
        identity in interface SpatialAnalyst
        Parameters:
        sourceGeometry - The Geometry object to be identified. Its type can be point, line, or region.
        operateGeometry - The Geometry object that is used to identify. Its type must be region.
        resultSetting - The result setting for spatial analysis on geometric objects.
        Returns:
        The identity analysis result.

      • intersect

        public DatasetSpatialAnalystResult intersect(java.lang.String sourceDataset,
                                    QueryParameter sourceDatasetFilter,
                                    java.lang.String operateDataset,
                                    QueryParameter operateDatasetFilter,
                                    DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an intersect operation on two datasets.

        Specified by:
        intersect in interface SpatialAnalyst
        Parameters:
        sourceDataset - The ID of the dataset to be intersected (the first dataset). It can be the point, line, or region type.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateDataset - The ID of the intersecting dataset (the second dataset). It can only be the region type.
        operateDatasetFilter - The filter query parameter for the second dataset. It can be null.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The intersect analysis result.

      • intersect

        public DatasetSpatialAnalystResult intersect(java.lang.String sourceDataset,
                                    QueryParameter sourceDatasetFilter,
                                    Geometry[] operateGeometries,
                                    DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an intersect operation on a dataset using specified region objects.

        Specified by:
        intersect in interface SpatialAnalyst
        Parameters:
        sourceDataset - The ID of the dataset to be intersected (the first dataset). It can be the point, line, or region type.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateGeometries - The array of intersecting region objects.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The intersect analysis result.

      • intersect

        public GeometrySpatialAnalystResult intersect(Geometry sourceGeometry,
                                     Geometry operateGeometry,
                                     GeometrySpatialAnalystResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an intersect operation on two Geometries

        Specified by:
        intersect in interface SpatialAnalyst
        Parameters:
        sourceGeometry - The Geometry to be intersected. It can be the point, line, or region type.
        operateGeometry - The intersecting Geometry. It can only be the region type.
        resultSetting - The result setting for spatial analysis on geometric objects.
        Returns:
        The intersect analysis result.

      • union

        public DatasetSpatialAnalystResult union(java.lang.String sourceDataset,
                                QueryParameter sourceDatasetFilter,
                                java.lang.String operateDataset,
                                QueryParameter operateDatasetFilter,
                                DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs a union operation on two datasets.

        Specified by:
        union in interface SpatialAnalyst
        Parameters:
        sourceDataset - The identifier of the dataset to be unioned (the first dataset). The type of this dataset must be region.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateDataset - The identifier of the dataset that is used to union (the second dataset). The type of this dataset must be region.
        operateDatasetFilter - The filter query parameter for the second dataset. It can be null.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The union analysis result.

      • union

        public DatasetSpatialAnalystResult union(java.lang.String sourceDataset,
                                QueryParameter sourceDatasetFilter,
                                Geometry[] operateGeometries,
                                DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs a union operation on a dataset by using specified region objects.

        Specified by:
        union in interface SpatialAnalyst
        Parameters:
        sourceDataset - The identifier of the dataset to be unioned (the first dataset). The type of this dataset must be region.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateGeometries - The array of the region objects that are used to union.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The union analysis result.

      • union

        public GeometrySpatialAnalystResult union(Geometry sourceGeometry,
                                 Geometry operateGeometry,
                                 GeometrySpatialAnalystResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs a union operation by using two Geometry objects.

        Specified by:
        union in interface SpatialAnalyst
        Parameters:
        sourceGeometry - The Geometry object to be unioned. Its type must be region.
        operateGeometry - The Geometry object that is used to union. Its type must be region.
        resultSetting - The result setting for spatial analysis on geometric objects.
        Returns:
        The union analysis result.

      • update

        public DatasetSpatialAnalystResult update(java.lang.String sourceDataset,
                                 QueryParameter sourceDatasetFilter,
                                 java.lang.String operateDataset,
                                 QueryParameter operateDatasetFilter,
                                 DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an update operation by using two datasets.

        Specified by:
        update in interface SpatialAnalyst
        Parameters:
        sourceDataset - The ID of the dataset to be updated (the first dataset). It must be the region type.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateDataset - The ID of the dataset used for updating (the second dataset). It must be the region type.
        operateDatasetFilter - The filter query parameter for the second dataset. It can be null.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The update analysis result.

      • update

        public DatasetSpatialAnalystResult update(java.lang.String sourceDataset,
                                 QueryParameter sourceDatasetFilter,
                                 Geometry[] operateGeometries,
                                 DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an update operation to a dataset by using specified region objects.

        Specified by:
        update in interface SpatialAnalyst
        Parameters:
        sourceDataset - The ID of the dataset to be updated (the first dataset). This dataset must be the region type.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateGeometries - The array of the region objects that are used to update.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The update analysis result.

      • update

        public GeometrySpatialAnalystResult update(Geometry sourceGeometry,
                                  Geometry operateGeometry,
                                  GeometrySpatialAnalystResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an update operation by using two Geometry objects.

        Specified by:
        update in interface SpatialAnalyst
        Parameters:
        sourceGeometry - The Geometry object to be updated. Its type must be region.
        operateGeometry - The Geometry object that is used to update. Its type must be region.
        resultSetting - The result setting for spatial analysis on geometric objects.
        Returns:
        The update analysis result.

      • clip

        public DatasetSpatialAnalystResult clip(java.lang.String sourceDataset,
                               QueryParameter sourceDatasetFilter,
                               java.lang.String operateDataset,
                               QueryParameter operateDatasetFilter,
                               DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs a clip operation by using two datasets.

        Specified by:
        clip in interface SpatialAnalyst
        Parameters:
        sourceDataset - The ID of the dataset to be clipped (the first dataset). It can be of the point, line, or region type.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateDataset - The identifier of the dataset that is used to clip (the second dataset). The type of this dataset must be region.
        operateDatasetFilter - The filter query parameter for the second dataset. It can be null.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The clip analysis result.

      • getRelativePosition3D

        public SpatialQuery3DResult getRelativePosition3D(java.lang.String sourceDataset,
                                         QueryParameter sourceDatasetFilter,
                                         java.lang.String operateDataset,
                                         QueryParameter operateDatasetFilter,
                                         DatasetSpatialQuery3DResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs 3D spatial analysis operations with two datasets.

        Specified by:
        getRelativePosition3D in interface SpatialAnalyst
        Parameters:
        sourceDataset - The source dataset identifier (also known as the first dataset). The type is 3D model dataset.
        sourceDatasetFilter - The filter of the first dataset, which can be null.
        operateDataset - The dataset identifier used to set the type of the operation (also known as the second dataset). The dataset type must be polygon.
        operateDatasetFilter - The filter of the second dataset, which can be null.
        resultSetting - The result settings to perform 3D spatial analysis with datasets.
        Returns:
        3D spatial analysis result.

      • getRelativePosition3D

        public SpatialQuery3DResult getRelativePosition3D(java.lang.String sourceDataset,
                                         QueryParameter sourceDatasetFilter,
                                         Geometry operateGeometry,
                                         double bottomAltitude,
                                         double extendedHeight,
                                         DatasetSpatialQuery3DResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs 3D spatial analysis operation on a dataset with the specified 3D object.

        Specified by:
        getRelativePosition3D in interface SpatialAnalyst
        Parameters:
        sourceDataset - The source dataset identifier (also known as the first dataset). The type is 3D model dataset.
        sourceDatasetFilter - The filter of the first dataset, which can be null.
        resultSetting - The result settings to perform 3D spatial analysis with datasets.
        Returns:
        The result of 3D spatial analysis.

      • spatialQuery3D

        public SpatialQuery3DResult spatialQuery3D(java.lang.String sourceDataset,
                                  QueryParameter sourceDatasetFilter,
                                  java.lang.String operateDataset,
                                  QueryParameter operateDatasetFilter,
                                  PositionMode posMode,
                                  DatasetSpatialQuery3DResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs 3D spatial analysis operation with two datasets.

        Specified by:
        spatialQuery3D in interface SpatialAnalyst
        Parameters:
        sourceDataset - The source dataset identifier (also known as the first dataset). The type is 3D model dataset.
        sourceDatasetFilter - The filter of the first dataset, which can be null.
        operateDataset - The dataset identifier used to set the type of the operation (also known as the second dataset). The dataset type must be polygon.
        operateDatasetFilter - The filter of the second dataset, which can be null.
        resultSetting - The result settings to perform 3D spatial analysis with datasets.
        Returns:
        3D spatial analysis result.

      • spatialQuery3D

        public SpatialQuery3DResult spatialQuery3D(java.lang.String sourceDataset,
                                  QueryParameter sourceDatasetFilter,
                                  Geometry operateGeometry,
                                  double bottomAltitude,
                                  double extendedHeight,
                                  PositionMode posMode,
                                  DatasetSpatialQuery3DResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs 3D spatial analysis operation on a dataset with the specified 3D object.

        Specified by:
        spatialQuery3D in interface SpatialAnalyst
        Parameters:
        sourceDataset - The source dataset identifier (also known as the first dataset). The type is 3D model dataset.
        sourceDatasetFilter - The filter of the first dataset, which can be null.
        resultSetting - The result settings to perform 3D spatial analysis with datasets.
        Returns:
        The result of 3D spatial analysis.

      • getRelativePosition3D

        public SpatialQuery3DResult getRelativePosition3D(Geometry sourceGeometry,
                                         double bottomAltitudeSource,
                                         double extendedHeightSource,
                                         Geometry operateGeometry,
                                         double bottomAltitudeOperate,
                                         double extendedHeightOperate,
                                         GeometrySpatialAnalystResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs 3D spatial analysis operation on a dataset with the specified 3D object.

        Specified by:
        getRelativePosition3D in interface SpatialAnalyst
        resultSetting - The result settings to perform 3D spatial analysis with datasets.
        Returns:
        The result of 3D spatial analysis.

      • clip

        public DatasetSpatialAnalystResult clip(java.lang.String sourceDataset,
                               QueryParameter sourceDatasetFilter,
                               Geometry[] operateGeometries,
                               DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs a clip operation to a dataset by using specified region objects.

        Specified by:
        clip in interface SpatialAnalyst
        Parameters:
        sourceDataset - The ID of the dataset to be clipped (the first dataset). It can be of the point, line, or region type.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateGeometries - The array of the region objects that are used to clip.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The clip analysis result.

      • clip

        public GeometrySpatialAnalystResult clip(Geometry sourceGeometry,
                                Geometry operateGeometry,
                                GeometrySpatialAnalystResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs a clip operation by using two Geometry objects.

        Specified by:
        clip in interface SpatialAnalyst
        Parameters:
        sourceGeometry - The Geometry object to be clipped. Its type can be either line or area.
        operateGeometry - The Geometry object that is used to clip. Its type must be region.
        resultSetting - The result setting for spatial analysis on geometric objects.
        Returns:
        The clip analysis result.

      • xor

        public DatasetSpatialAnalystResult xor(java.lang.String sourceDataset,
                              QueryParameter sourceDatasetFilter,
                              java.lang.String operateDataset,
                              QueryParameter operateDatasetFilter,
                              DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an xor operation on two datasets.

        Specified by:
        xor in interface SpatialAnalyst
        Parameters:
        sourceDataset - The ID of the dataset to be operated on (the first dataset). It must be the region type.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateDataset - The ID of the operating dataset (the second dataset). It must be the region type.
        operateDatasetFilter - The filter query parameter for the second dataset. It can be null.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The xor analysis result.

      • xor

        public DatasetSpatialAnalystResult xor(java.lang.String sourceDataset,
                              QueryParameter sourceDatasetFilter,
                              Geometry[] operateGeometries,
                              DatasetOverlayResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an xor operation on a dataset using specified region objects.

        Specified by:
        xor in interface SpatialAnalyst
        Parameters:
        sourceDataset - The ID of the dataset to be operated on (the first dataset). It must be the region type.
        sourceDatasetFilter - The filter query parameter for the first dataset. It can be null.
        operateGeometries - The array of operating objects.
        resultSetting - The result setting for overlay analysis on datasets.
        Returns:
        The xor analysis result.

      • xor

        public GeometrySpatialAnalystResult xor(Geometry sourceGeometry,
                               Geometry operateGeometry,
                               GeometrySpatialAnalystResultSetting resultSetting)
        Description copied from interface: SpatialAnalyst

        Performs an xor operation on two Geometries.

        Specified by:
        xor in interface SpatialAnalyst
        Parameters:
        sourceGeometry - The Geometry object to be operated on. Its type must be region.
        operateGeometry - The operating Geometry. It can only be the region type.
        resultSetting - The result setting for spatial analysis on geometric objects.
        Returns:
        The xor analysis result.

      • extractIsoregion

        public DatasetSpatialAnalystResult extractIsoregion(java.lang.String pointDataset,
                                           QueryParameter filterQueryParameter,
                                           java.lang.String zValueField,
                                           double resolution,
                                           ExtractParameter parameter,
                                           DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Used to extract the isoregions from the point dataset. The operation process of this method is creating a grid dataset (It is the intermediate result) from the points through interpolation analysis firstly, and then extracting the isoregions from the grid dataset.

        Specified by:
        extractIsoregion in interface SpatialAnalyst
        Parameters:
        pointDataset - The ID (datasetName@datasourceName) of the point dataset to be analyzed.
        filterQueryParameter - The filtering condition used to filter out certain features in the point dataset. Only points that meet the filtering condition will be included in the analysis.
        zValueField - The name of the elevation field.
        resolution - The resolution of the intermediate raster dataset.
        parameter - The parameter for extracting isoregions. Required. It is used to set the smoothness, the resampling interval, etc. Please see ExtractParameter class.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • extractIsoregion

        public DatasetSpatialAnalystResult extractIsoregion(java.lang.String pointDataset,
                                           QueryParameter filterQueryParameter,
                                           java.lang.String zValueField,
                                           double resolution,
                                           ExtractParameter parameter,
                                           DataReturnOption resultSetting,
                                           InterpolateType terrainInterpolateType)
        Description copied from interface: SpatialAnalyst

        Used to extract the isoregions from the point dataset. The operation process of this method is creating a grid dataset (It is the intermediate result) from the points through interpolation analysis firstly, and then extracting the isoregions from the grid dataset.

        Specified by:
        extractIsoregion in interface SpatialAnalyst
        Parameters:
        pointDataset - The ID (datasetName@datasourceName) of the point dataset to be analyzed.
        filterQueryParameter - The filtering condition used to filter out certain features in the point dataset. Only points that meet the filtering condition will be included in the analysis.
        zValueField - The name of the elevation field.
        resolution - The resolution of the intermediate raster dataset.
        parameter - The parameter for extracting isoregions. Required. It is used to set the smoothness, the resampling interval, etc. Please see ExtractParameter class.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • extractIsoline

        public DatasetSpatialAnalystResult extractIsoline(java.lang.String pointDataset,
                                         QueryParameter filterQueryParameter,
                                         java.lang.String zValueField,
                                         double resolution,
                                         ExtractParameter parameter,
                                         DataReturnOption resultSetting,
                                         InterpolateType terrainInterpolateType)
        Description copied from interface: SpatialAnalyst

        Used to extract the isolines from the point dataset. The operation process of this method is creating a grid dataset (It is the intermediate result) from the points through interpolation analysis firstly, and then extracting the isolines from the grid dataset.

        Specified by:
        extractIsoline in interface SpatialAnalyst
        Parameters:
        pointDataset - The identifier of the point dataset for this analysis (datasetName@datasourceName).
        zValueField - The name of the elevation field.
        resolution - The resolution of the intermediate raster dataset.
        parameter - The parameter for extracting isolines. Required. It is used to set the smoothness, the resampling interval, etc. Please see ExtractParameter class.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • extractIsoregion

        public DatasetSpatialAnalystResult extractIsoregion(java.lang.String gridDataset,
                                           ExtractParameter parameter,
                                           DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Extracts isoregions from a raster dataset.

        Specified by:
        extractIsoregion in interface SpatialAnalyst
        Parameters:
        gridDataset - The identifier of the raster dataset for this analysis.
        parameter - The parameter for extracting isoregions. Required. It is used to set the smoothness, the resampling interval, etc. Please see ExtractParameter class.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • extractIsoregion

        public DatasetSpatialAnalystResult extractIsoregion(Point2D[] points,
                                           double[] zValues,
                                           double resolution,
                                           ExtractParameter parameter,
                                           DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Extracts isoregions from a point set. The implementation principle of this method is to first perform an interpolation analysis on the points using the 3rd dimension information, such as elevation and temperature, aside from the coordinate data stored in the point set. A raster dataset (an intermediate result dataset) is obtained. Isoregions are then extracted from the raster dataset.

        Specified by:
        extractIsoregion in interface SpatialAnalyst
        Parameters:
        points - The array of the points for analyzing.
        zValues - The array of Z values of the points. This array must have the same length with the length of the points array.
        resolution - The resolution of the intermediate raster dataset.
        parameter - The parameter object for surface analysis. Please see ExtractParameter class.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • extractIsoregion

        public DatasetSpatialAnalystResult extractIsoregion(Point2D[] points,
                                           double[] zValues,
                                           double resolution,
                                           ExtractParameter parameter,
                                           DataReturnOption resultSetting,
                                           InterpolateType terrainInterpolateType)
        Description copied from interface: SpatialAnalyst

        Extracts isoregions from a point set. The implementation principle of this method is to first perform an interpolation analysis on the points using the 3rd dimension information, such as elevation and temperature, aside from the coordinate data stored in the point set. A raster dataset (an intermediate result dataset) is obtained. Isoregions are then extracted from the raster dataset.

        Specified by:
        extractIsoregion in interface SpatialAnalyst
        Parameters:
        points - The array of the points for analyzing.
        zValues - The array of Z values of the points. This array must have the same length with the length of the points array.
        resolution - The resolution of the intermediate raster dataset.
        parameter - The parameter object for surface analysis. Please see ExtractParameter class.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • extractIsoline

        public DatasetSpatialAnalystResult extractIsoline(java.lang.String pointDataset,
                                         QueryParameter filterQueryParameter,
                                         java.lang.String zValueField,
                                         double resolution,
                                         ExtractParameter parameter,
                                         DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Used to extract the isolines from the point dataset. The operation process of this method is creating a grid dataset (It is the intermediate result) from the points through interpolation analysis firstly, and then extracting the isolines from the grid dataset.

        Specified by:
        extractIsoline in interface SpatialAnalyst
        Parameters:
        pointDataset - The identifier of the point dataset for this analysis (datasetName@datasourceName).
        zValueField - The name of the elevation field.
        resolution - The resolution of the intermediate raster dataset.
        parameter - The parameter for extracting isolines. Required. It is used to set the smoothness, the resampling interval, etc. Please see ExtractParameter class.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • extractIsoline

        public DatasetSpatialAnalystResult extractIsoline(java.lang.String gridDataset,
                                         ExtractParameter parameter,
                                         DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Extracts the isolines from the grid dataset.

        Specified by:
        extractIsoline in interface SpatialAnalyst
        Parameters:
        gridDataset - The identifier of the raster dataset for this analysis.
        parameter - The parameter for extracting isolines. Required. It is used to set the smoothness, the resampling interval, etc. Please see ExtractParameter class.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • extractIsoline

        public DatasetSpatialAnalystResult extractIsoline(Point2D[] points,
                                         double[] zValues,
                                         double resolution,
                                         ExtractParameter parameter,
                                         DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Extracts isolines from a point set. The implementation principle of this method is to first perform an interpolation analysis on the points using the 3rd dimension information, such as elevation and temperature, aside from the coordinate data stored in the point set. A raster dataset (an intermediate result dataset) is obtained. Isolines are then extracted from the raster dataset.

        Specified by:
        extractIsoline in interface SpatialAnalyst
        Parameters:
        points - The array of the points for analyzing.
        zValues - The array of Z values of the points. This array must have the same length with the length of the points array.
        resolution - The resolution of the intermediate raster dataset.
        parameter - The parameter object for surface analysis. Please see ExtractParameter class.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • extractIsoline

        public DatasetSpatialAnalystResult extractIsoline(Point2D[] points,
                                         double[] zValues,
                                         double resolution,
                                         ExtractParameter parameter,
                                         DataReturnOption resultSetting,
                                         InterpolateType terrainInterpolateType)
        Description copied from interface: SpatialAnalyst

        Extracts isolines from a point set. The implementation principle of this method is to first perform an interpolation analysis on the points using the 3rd dimension information, such as elevation and temperature, aside from the coordinate data stored in the point set. A raster dataset (an intermediate result dataset) is obtained. Isolines are then extracted from the raster dataset.

        Specified by:
        extractIsoline in interface SpatialAnalyst
        Parameters:
        points - The array of the points for analyzing.
        resolution - The resolution of the intermediate raster dataset.
        parameter - The parameter object for surface analysis. Please see ExtractParameter class.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the information according to the result setting for surface analysis.

      • interpolate

        public InterpolationResult interpolate(InterpolationParameter interpolationParameter)
        Description copied from interface: SpatialAnalyst

        Used to gets raster dataset by performing interpolation analysis on discrete point data. Interpolation analysis can forecast the values around the sampling points and know the whole distribution of the data in the target region, the sampling points don’t only reflect the values of themselves, but the whole region.

        Specified by:
        interpolate in interface SpatialAnalyst
        Parameters:
        interpolationParameter - The interpolation parameter object. Please see InterpolationParameter class.
        Returns:
        Returns the raster dataset resulted from the interpolation analysis.

      • generateSpatialData

        public DatasetSpatialAnalystResult generateSpatialData(GenerateSpatialDataParameter generateSpatialDataParameter,
                                              DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Executes the dynamic segmentation.

        The general process of dynamic segmentation is:

        1. Prepare the route dataset and event table
        2. Recreate the dynamic segmentation result according to the route dataseta and event table, namely, a spatial dataset
        3. Display the spatial data on client side
        Specified by:
        generateSpatialData in interface SpatialAnalyst
        Parameters:
        generateSpatialDataParameter - The parameter for dynamic segmentation function, including route dataset name, route identifier field, event table dataset name, route identifier field in event table dataset, scale field of point event table, start and end scale field of line event table, offset field, error information field, etc.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        The dynamic segmentation result, namely, a spatial dataset.

      • geoRelation

        public GeoRelationResult<?>[] geoRelation(GeoRelationParameter geoRelationParameter)
        Description copied from interface: SpatialAnalyst

        The spatial relation analysis of objects in two datasets.

        Specified by:
        geoRelation in interface SpatialAnalyst
        Parameters:
        geoRelationParameter - Spatial relationship analysis parameter.
        Returns:
        The analysis result array of spatial relation.

      • calculateAspect

        public DatasetSpatialAnalystResult calculateAspect(java.lang.String gridDataset,
                                          TerrainAnalystSetting terrainAnalystSetting,
                                          DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Calculates aspect, and returns the aspect grid dataset, i.e., aspect map.

        Aspect is the direction a slope faces. It is the steepest downslope direction at a certain location on terrain surface. Slope aspect is measured in degrees. It ranges from 0 (the north direction) to 360 degrees with the clockwise direction as the positive direction.

        Specified by:
        calculateAspect in interface SpatialAnalyst
        Parameters:
        gridDataset - The identifier of the raster dataset for aspect analysis.
        terrainAnalystSetting - The settings for terrain analysis.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the result information of aspect analysis.

      • calculateCurvature

        public java.util.List<DatasetSpatialAnalystResult> calculateCurvature(java.lang.String gridDataset,
                                                             double zFactor,
                                                             java.lang.String profileCurvatureName,
                                                             java.lang.String planCurvatureName,
                                                             DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Calculates the curvature.

        Specified by:
        calculateCurvature in interface SpatialAnalyst
        Parameters:
        gridDataset - The grid dataset identifiers of slope analysis.
        zFactor - The specified elevation scale factor. The z-factor adjusts the units of measure for the z units when they are different from the x,y units of the input surface. For example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter). In general, z-factor is used for a calculation involves x,y,z. The default value is 1, which means the x,y and z units are in the same units of measure.
        profileCurvatureName - The name of the output profile curvature dataset.
        planCurvatureName - The name of the output plane curvature dataset.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        The curvature calculation result.

      • calculateSlope

        public DatasetSpatialAnalystResult calculateSlope(java.lang.String gridDataset,
                                         TerrainAnalystSetting terrainAnalystSetting,
                                         SlopeType slopeType,
                                         double zFactor,
                                         DataReturnOption resultSetting)
        Description copied from interface: SpatialAnalyst

        Calculates slope, and returns the slope grid dataset, i.e., slope map.

        Slope is the included angle formed by the tangent surface of a point on Earth and the horizontal surface. Every cell in a slope map has a slope value. A greater slope indicates steeper terrain. Slope can be measured in degrees, radians, or percentages. It is used to calculate the average slope values of the cell surfaces in a grid dataset. The values in the calculation result range from 0 to 90 degrees.

        Specified by:
        calculateSlope in interface SpatialAnalyst
        Parameters:
        gridDataset - The identifier of the raster dataset for slope analysis.
        terrainAnalystSetting - The environment setting of terrain analysis.
        slopeType - The unit type of the specified slope. The default angle is DEGREE.
        zFactor - The specified elevation scale factor. The z-factor adjusts the units of measure for the z units when they are different from the x,y units of the input surface. For example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter). In general, z-factor is used for a calculation involves x,y,z. The default value is 1, which means the x,y and z units are in the same units of measure.
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        Returns:
        Returns the result information of slope analysis.

      • computeSurfaceArea

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

        Surface area calculation. It calculates the total surface area of a 3D curved surface within a selected polygon region. The curved surface is simulated by a grid dataset.

        Specified by:
        computeSurfaceArea in interface SpatialAnalyst
        Parameters:
        gridDataset - The raster dataset identifier used to calculate the surface area.
        region - The polygon used to calculate the surface area.
        Returns:
        Surface area calculation result.

      • computeSurfaceDistance

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

        Calculates surface distance. It is used to calculate curved surface distance along specified line segments or polyline segments on a 3D curved surface simulated by a grid dataset.

        Specified by:
        computeSurfaceDistance in interface SpatialAnalyst
        Parameters:
        gridDataset - The raster dataset identifier used to calculate the surface area.
        line - The 2D line used to calculate the surface distance.
        Returns:
        Surface area calculation result.

      • calculateProfile

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

        Analyzes the profile for a grid dataset.

        Specified by:
        calculateProfile in interface SpatialAnalyst
        Parameters:
        gridDataset - The specified grid dataset for profile analysis.
        line - The specified start and end range for the profile. It is a line.
        resampleTolerance - The specified tolerance for resampling.
        Returns:
        The profile analysis result.

      • calculateProfile

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

        Analyzes the profile for a grid dataset.

        Specified by:
        calculateProfile in interface SpatialAnalyst
        Parameters:
        gridDataset - The specified grid dataset for profile analysis.
        lineDataset - The specified dataset to calculate the aspect. It is a line dataset.
        resampleTolerance - The specified tolerance for resampling.
        Returns:
        The profile analysis result.

      • calculatePlumbProfile

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

        Performs the profile analysis for the terrain or model according to the specified profile line.

        Specified by:
        calculatePlumbProfile in interface SpatialAnalyst
        Parameters:
        startPoint - The start point of the specified secant line.
        endPoint - The end point of the specified secant line.
        modelDatasets - The specified model dataset collection. Optional, but at least specifies a surface raster dataset or a model dataset.
        surfaceGrid - The specified surface raster dataset. Optional, but at least specifies a surface raster dataset or a model dataset.
        returnRecordsetOrDataset - Returns the recordset or dataset.
        Returns:

      • costPathLine

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

        Raster shortest path analysis.

        Performs the least cost path grid analysis according to given parameters. This method calculates the least-cost paths between specified sources and target points.

        Specified by:
        costPathLine in interface SpatialAnalyst
        Parameters:
        sourcePoint - The specific source point.
        targetPoint - The specified target point.
        gridDataset - The specified cost distance. It is a raster dataset. The value of each cell in this dataset represents the cost to travel through this cell.
        smoothMethod - The specified smoothing method for processing the least-cost paths.
        smoothDegree - The specified smooth degree. 1 indicates that the result will not be smoothed. A greater value will result in a greater smoothness and a lower efficiency. The recommended range is [1,3].
        resultSetting - The result setting parameter, including whether to return the record, whether to generate result dataset, etc.
        maxUpslopeDegree - The specified maximum uphill angle when calculating the shortest route between two points (source and target).
        maxDownslopeDegree - The specified maximum downhill angle when calculating the shortest route between two points (source and target).
        Returns:
        The least-cost path result.

      • cutFill

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

        Rater cut and fill calculation.

        Surface materials on the Earth surface usually move as they are eroded and deposited, which result in accumulation of surface materials in some area and loss in some other. In an engineering project, the loss of surface materials is called "Cut", and the increase of surface materials is called "Fill". A grid cut and fill calculation requires two input grid datasets: the dataset before a cutting and filling operation and the one after. The value of each cell in the result dataset is the difference between the values of the corresponding cell in the two input datasets. A positive cell value indicates that the surface material at that cell has reduced; a negative cell value indicates the surface material there has increased. The two input grid datasets must have the same coordinate system and projection, so that a point on the Earth would have the same coordinates in the two datasets. If the coordinate systems of the two grid datasets are not the same, an erroneous result may be produced. Theoretically, the spatial extents of the two input grid datasets should be the same. If not, only the overlapped part will participate in the cut and fill calculation. If a cell in a grid dataset has a null value, the corresponding cell in the result dataset will have a null value too.

        Specified by:
        cutFill in interface SpatialAnalyst
        Parameters:
        gridDataset - The original grid dataset used in cut and fill.
        afterCutFillDataset - The grid dataset after the cut and fill operation.
        resultDataset - The result dataset after the cut and fill analysis.
        deleteExistResultDataset - Whether to delete the existing dataset if the name of the result dataset named by users is the same as that of an existing dataset.
        buildPyramid - Whether creating image pyramid or not for the result raster dataset.
        Returns:
        Cut and fill calculation result.

      • cutFill

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

        Cut and fill for a selected region.

        It can be applied when a region with ridges and valleys is to be flattened. The user can specify the region to be flattened and the target elevation. This method can be used to calculate the filled area, the cut area, the fill volume, and the cut volume.

        Specified by:
        cutFill in interface SpatialAnalyst
        Parameters:
        gridDataset - The original grid dataset used in cut and fill.
        region - Cut and fill area.
        baseAltitude - The result elevation of the specified region to be cut and filled.
        resultDataset - The result dataset after the cut and fill analysis.
        deleteExistResultDataset - Whether to delete the existing dataset if the name of the result dataset named by users is the same as that of an existing dataset.
        buildPyramid - Whether creating image pyramid or not for the result raster dataset.
        Returns:
        Cut and fill calculation result.

      • cutFill

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

        Incline cut and fill.

        The incline cut and fill. This function calculates the volume needed to be cut and filled to create a slope on the terrain surface. The principle is similar to cutting and filling for a selected region. It makes use of specifying cut and fill route, buffer radius to construct the required filled area, cut area, fill volume, and cut volume.

        Specified by:
        cutFill in interface SpatialAnalyst
        Parameters:
        gridDataset - The original grid dataset used in cut and fill.
        line3D - The specified cut and fill route.
        bufferRadius - The buffer radius of the specified cut and fill route.
        isRoundHead - Whether to use a round buffer for the cut and fill route.
        resultDataset - The result dataset after the cut and fill analysis.
        deleteExistResultDataset - Whether to delete the existing dataset if the name of the result dataset named by users is the same as that of an existing dataset.
        buildPyramid - Whether creating image pyramid or not for the result raster dataset.
        Returns:
        Cut and fill calculation result.

      • flood

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

        Flood analysis. Calculates the flooded area according to the specified height in the raster dataset.

        Specified by:
        flood in interface SpatialAnalyst
        Parameters:
        gridDataset - Raster dataset identifier for calculating the flood area.
        floodHeigth - The water elevation.
        validRegion - The valid region. Only this region is calculated.
        Returns:
        Flood analysis result.

      • extractValleyLine

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

        Extracts the valley line.

        Specified by:
        extractValleyLine in interface SpatialAnalyst
        Parameters:
        gridDataset - The specified DEM data on which to extract the valley lines.
        targetDatasource - Used to store the result dataset. If set to null, the result will be stored into the same datasource with that of surfaceGrid dataset.
        resultGridName - The name of the result dataet.
        deleteExistResultDataset - Whether to delete the existing result dataset.
        Returns:
        The analysis result.

      • extractRidgeLine

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

        Extracts the ridge line.

        Specified by:
        extractRidgeLine in interface SpatialAnalyst
        Parameters:
        gridDataset - The specified DEM data on which to extract the ridge lines.
        targetDatasource - Used to store the result dataset. If set to null, the result will be stored into the same datasource with that of surfaceGrid dataset.
        resultGridName - The name of the result dataet.
        deleteExistResultDataset - Whether to delete the existing result dataset.
        Returns:
        The analysis result.

      • cutFill

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

        Back-calculates cut and fill.

        That is calculating the expected elevation after performing cut and fill according to the specified volume for filling or cutting.

        Specified by:
        cutFill in interface SpatialAnalyst
        Parameters:
        gridDataset - The specified grid data to be cut and filled.
        volume - The specified volume for filling or cutting. The value is a value greater than 0, and if set to less than or equal to 0, an exception will be thrown.
        isFill - Specifies whether to do fill and cut calculation. True, calculate; false, otherwise.
        validRegion - The valid region. After specified this region, the cut and fill operation will be conducted in this region. If this parameter is null, the cut and fill operation will be conducted in the whole grid dataset.
        Returns:
        The elevation after cut or fill.

      • locatePoint

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

        Gets the point object of M specified by the route object.

        Specified by:
        locatePoint in interface SpatialAnalyst
        Parameters:
        sourceRoute - The route object.
        measure - The specified M value.
        offset - The offset of result point.
        isIgnoreGap - Whether to ignore the distances between parts.
        Returns:
        The point object of M specified by the route object.

      • locatePoint

        public GeometrySpatialAnalystResult locatePoint(java.lang.String datasetName,
                                       java.lang.String routeIdField,
                                       java.lang.String routeId,
                                       double measure,
                                       double offset,
                                       boolean isIgnoreGap)
        Description copied from interface: SpatialAnalyst

        Gets the point object of M specified by the route object.

        Specified by:
        locatePoint in interface SpatialAnalyst
        Parameters:
        datasetName - The dataset name.
        routeIdField - The route ID field.
        routeId - The route object identifier.
        measure - The specified M value.
        offset - The offset of result point.
        isIgnoreGap - Whether to ignore the distances between parts.
        Returns:
        The point object of M specified by the route object.

      • locateLine

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

        Returns the corresponding line objects with the given start and end M values.

        Specified by:
        locateLine in interface SpatialAnalyst
        Parameters:
        sourceRoute - The route object.
        startMeasure - The specified start M value.
        endMeasure - The specified end M value.
        Returns:
        The corresponding line objects with the given start and end M values.

      • locateLine

        public GeometrySpatialAnalystResult locateLine(java.lang.String datasetName,
                                      java.lang.String routeIdField,
                                      java.lang.String routeId,
                                      double startMeasure,
                                      double endMeasure)
        Description copied from interface: SpatialAnalyst

        Returns the corresponding line objects with the given start and end M values.

        Specified by:
        locateLine in interface SpatialAnalyst
        Parameters:
        datasetName - The dataset name.
        routeIdField - The route ID field.
        routeId - The route object identifier.
        startMeasure - The specified start M value.
        endMeasure - The specified end M value.
        Returns:
        The corresponding line objects with the given start and end M values.

      • calculateMeasureAtPoint

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

        Calculates the M value of the specified point with the specified route object.

        Specified by:
        calculateMeasureAtPoint in interface SpatialAnalyst
        Parameters:
        sourceRoute - The route object.
        point - The specified point object.
        tolerance - The tolerance.
        isIgnoreGap - Whether to ignore the distances between parts.
        Returns:
        The M value of the specified point object.

      • executeMathAnalystExpression

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

        Performs a grid algebraic operation expression.

        Specified by:
        executeMathAnalystExpression in interface SpatialAnalyst
        Parameters:
        expression - A custom grid algebraic operation expression.
        extractRegion - User-specified valid calculation area. If it is null, calculate entire region. If the datasets are not inconformity, use the intersection to calculate.
        isZip - Whether to compress the result dataset. true means compression.
        ignoreNoValue - Whether to ignore the no-value grid data. true means ignore; otherwise, false.
        targetDatasource - The specified datasource used for storing result dataset.
        resultGridName - The specified result dataset.
        deleteExistResultDataset - Whether to delete the existing result dataset.
        Returns:
        The analysis result.

      • kernelDensity

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

        Performs kernel density analysis on point dataset or line dataset. Return the result grid dataset.

        Specified by:
        kernelDensity in interface SpatialAnalyst
        Parameters:
        inputParam - The parameters needed in kernel density analysis.
        sourceDatasetTag - The point or line datasets identification used to perform kernel density analysis (datasetName@datasourceName).
        fieldName - The field name of the measured value used to perform the density analysis. The density analysis doesn't support text field.
        targetDatasource - The specified datasource used for storing result dataset.
        resultGridName - The specified result dataset.
        deleteExistResultDataset - Whether to delete the existing result dataset.
        Returns:
        The result of kernel density analysis.

      • cutFill

        public CutFillResult cutFill(java.lang.String gridDataset,
                    Geometry3D region3D,
                    java.lang.String resultDataset,
                    boolean deleteExistResultDataset,
                    boolean buildPyramid)
        Description copied from interface: SpatialAnalyst

        3D region Cut and Fill.

        It can be applied when a region with ridges and valleys is to be cut and filled into a specified expected 3D region. The filled area, the cut area, the fill volume, and the cut volume can be calculated.

        Specified by:
        cutFill in interface SpatialAnalyst
        Returns:
        Cut and fill calculation result.