学习在 ArcEngine 中使用 Geoprocessing

    作者：Flyingis

    Geoprocessing对于ArcGIS使用者来说，是一种非常方便实用的工具，它可以利用ArcToolbox中的各种工具为我们的地理空间工作流进行框架建模，自动执行空间分析与处理。

    过去我们可以在ArcToolbox中新建Model，或是写python脚本、AML来构建新的模型，现在ArcEngine 9.2单独提供了com.esri.arcgis.geoprocessing.tools工具包，使得在二次开发中通过Geoprocessing构建应用模型，将ArcGIS众多分析工具集成到我们的应用中成为现实。

    我们就在ArcEngine 9.2 for Java环境中看看如何使用Geoprocessing。

import com.esri.arcgis.geoprocessing.GeoProcessor;
import com.esri.arcgis.geoprocessing.tools.analysistools.Clip;
// Initialize the GeoProcessor 
GeoProcessor gp = new GeoProcessor();
Clip clip= new Clip("c:/data/mjrroads.shp", "c:/data/coasts.shp",  "c:/output/clipOutput.shp");

   
    设置参数

Clip clip = new Clip();
clip.setInFeatures = "c:/data/mjrroads.shp";
clip.setClipFeatures = "c:/data/coasts.shp";
clip.setOutFeatureClass = "c:/output/clipOutput.shp";

   
    代码中Clip构造方法，以及clip对象参数的设置，均和ArcToolbox-->Clip工具相对应。

    Geoprocessor类用来执行Geoprocessing相关工具的操作，geoprocessor的角色是一种helper对象，它的重载方法execute用来运行之前所定义的操作集。

GP.execute(clip, null);

 

    com.esri.arcgis.geoprocessing.IGeoProcessorResult接口的对象可以捕获execute执行后的结果。

// Intialize the Geoprocessor
GeoProcessor gp = new GeoProcessor();
// 使用web service中的toolbox
gp.addToolbox("http://flame7:8399/arcgis/services;GP/Bestpathtoolbox");
// 导入本地的shape文件 
ArrayList parameters = new ArrayList;
parameters.add("C:\\sandiego\\source.shp"); 
parameters.add("C:\\sandiego\\destination.shp");
// 捕获execute执行结果
IGeoProcessorResult result;
result = gp.execute("CalculateBestPath", parameters, null);

 

    名字冲突

    和OO语言处理名字冲突一样，当可能出现名字冲突时，可以使用全名来唯一指定所使用的工具：

ArcToolbox-->Analysis Tools-->Extract-->Clip
ArcToolbox-->Data Management-->Raster-->Clip

com.esri.arcgis.geoprocessing.tools.analysistools.Clip
com.esri.arcgis.geoprocessing.tools.datamanagementtools.Clip

 

    Geoprocessing编程的时候，还可以使用AO作为输入的工具

// Initialize the Geoprocessor 
GPUtilities gpUtilities = new GPUtilities();
IFeatureClass inputFeatureClass = gpUtilities.openFeatureClassFromString(inputData+"/canada/mjrroads.shp");
IFeatureClass clipFeatureClass = gpUtilities.openFeatureClassFromString(inputData+"/canada/coasts.shp");
Clip clip = new Clip(inputFeatureClass, clipFeatureClass, outputDirectory+"/clipOutput.shp");
gp.execute(clip, null);

 

    关于GPUtilities和Geoprocessor区别，可以看看这两段描述以及各自的类方法：

The GPUtilities object is mainly intended for developers building custom tools. For more information about building custom tools, refer to the technical document Building Geoprocessing Function Tools.

A geoprocessing tool is executed by a geoprocessor. The geoprocessor is a helper object that simplifies the task of executing tools. Toolboxes define the set of tools available for the geoprocessor. Toolboxes can be added and removed from the geoprocessor.

    ArcToolbox工具都有自己的环境设置，一般情况下我们使用默认值，在AE中可以用setEnvironmentValue方法来设置环境变量的值

// Get the Cell Size environment value
gp.setEnvironmentValue("cellsize", Double.valueOf(10.0));
String env = (String) gp.getEnvironmentValue("cellsize");

// Set the output Coordinate System environment            
gp.setEnvironmentValue("outputCoordinateSystem", "c:/Program Files/ArcGIS/Coordinate Systems/Projected Coordinate Systems/UTM/Nad 1983/NAD 1983 UTM Zone 21N.prj");

// Reset the environment values to their defaults.
gp.resetEnvironments();

 

    需要注意的是，在使用Geoprocessing建模进行各种空间操作时，我们需要相应的license授权来完成这些操作，如Spatial Join需要ArcInfo License，各种级别License描述可以参考下图：