ArcGIS Runtime SDK for Android开发之调用GP服务（异步调用）

一、背景说明

通过调用GP服务，Android客户端也能实现专业的、复杂的GIS分析处理功能，从而增加应用的实用价值。

ArcGIS Server发布的GP服务，分为同步和异步两种类型，一般执行步骤较多，耗时较长的GP服务都采用异步方式，执行速度较快的服务则采用同步方式。如果不确定GP服务是同步还是异步方式，则可以通过服务目录查看，如下图：

本文将介绍如何通过异步的方式来调用GP服务（同步方式在SDK的示例程序中有，较为简单），本例调用的GP服务来自ArcGIS Online，服务地址为：http://sampleserver4.arcgisonline.com/ArcGIS/rest/services/HomelandSecurity/Incident_Data_Extraction/GPServer/Extract%20Data%20Task。该服务相关的业务数据服务为：http://sampleserver4.arcgisonline.com/ArcGIS/rest/services/HomelandSecurity/Incident_Data_Extraction/MapServer。该GP服务提供数据提取的功能，就是根据用户选择的待提取图层、提取范围、输出格式，将数据提取，并打包返回客户端，由客户下载zip压缩包。先来看一下GP服务的参数要求：

可见该服务提供了三个输入参数，分别是：待提取的图层、提取范围和输出格式，此外还有一个输出参数，用于获取提取结果。

二、示例效果

本例的执行效果如下：

1.底图与待提取的业务数据：

2.绘制用于提取的多边形范围：

3.提交提取任务，开始执行提取操作：

4.提取任务执行完成，获得了提取结果的URL（图片上方），点击可下载：

5.完成下载提取结果：

6.到下载目录中查看下载结果，output-1.zip：

三、关键代码

1.设置参数

	public void startAsynchronous(Polygon aoiGeometry){
		//被裁切的目标图层
		GPString pointLayer = new GPString();
		pointLayer.setValue("Incident Points");		
		GPString lineLayer = new GPString();
		pointLayer.setValue("Incident Lines");		
		GPString polygonLayer = new GPString();
		pointLayer.setValue("Incident Areas");
		
		GPMultiValue<GPString> clipLayers = new GPMultiValue<GPString>("Layers_to_Clip");
		clipLayers.addValue(pointLayer);
		clipLayers.addValue(lineLayer);
		clipLayers.addValue(polygonLayer);
		
		//用于裁切的范围
		Graphic g = new Graphic(aoiGeometry, fillSymbol);
		GPFeatureRecordSetLayer aoi = new GPFeatureRecordSetLayer("Area_of_Interest");
		aoi.setGeometryType(Geometry.Type.POLYGON);
		aoi.addGraphic(g);
		
		//返回的数据格式
		GPString format = new GPString("Feature_Format");
		format.setValue("Shapefile - SHP - .shp");
		
		params2 = new ArrayList<GPParameter>();
		params2.add(clipLayers);
		params2.add(aoi);
		params2.add(format);
		
		try {
			dialog = ProgressDialog.show(Viewshed.this, "", "Extacting. Please wait...", true, true);
			
			gpExtract = new Geoprocessor("http://sampleserver4.arcgisonline.com/ArcGIS/rest/services/HomelandSecurity/Incident_Data_Extraction/GPServer/Extract%20Data%20Task");
			gpExtract.setOutSR(map.getSpatialReference());
			gpExtract.setProcessSR(map.getSpatialReference());
				
			ExtractRunable queryRunable = new ExtractRunable();
			Thread thread = new Thread(queryRunable);
			thread.start();			
		} 
		catch (Exception e) {
			e.printStackTrace();
		}
	}

2.提交任务，开始异步执行

    class ExtractRunable implements Runnable {
		@Override
		public void run() {
			GPJobResource jobResource = null;
			try {
				jobResource = gpExtract.submitJob(params2);
			} 
			catch (Exception e1) {				
				e1.printStackTrace();
			}
			jobID = jobResource.getJobID();
			
		}
    }

3.通过Timer定时查询任务状态并处理结果

    class ExtractRunable implements Runnable {
		@Override
		public void run() {
			GPJobResource jobResource = null;
			try {
				jobResource = gpExtract.submitJob(params2);
			} 
			catch (Exception e1) {				
				e1.printStackTrace();
			}
			jobID = jobResource.getJobID();
			
			//通过定时器每隔2秒查询Job状态
			checkJobStatusTimer = new Timer();
			checkJobStatusTimer.schedule(new TimerTask() {
				@Override
				public void run() {
					GPJobResource jobRes = null;
					try {
						jobRes = gpExtract.checkJobStatus(jobID);
					} 
					catch (Exception e) {						
						e.printStackTrace();
					}
					if(jobRes == null) return;
					JobStatus status = jobRes.getJobStatus();
					
					switch(status){
					case CANCELLED:
						Toast.makeText(Viewshed.this, "CANCELLED", Toast.LENGTH_LONG).show();
						break;
					case DELETED:
						Toast.makeText(Viewshed.this, "DELETED", Toast.LENGTH_LONG).show();
						break;
					case FAILED:
						GPMessage[] message = jobRes.getMessages();
						Toast.makeText(Viewshed.this, "FAILED:"+message[0].toString(), Toast.LENGTH_LONG).show();
						break;
					case SUCCEEDED:
						try {
							GPDataFile result = (GPDataFile)gpExtract.getResultData(jobID, "Output_Zip_File");
							url = result.getUrl();
							uiHandler.sendEmptyMessage(CLOSE_LOADING_WINDOW);							
						} 
						catch (Exception e) {
							e.printStackTrace();
						}
						
						break;
					case TIMED_OUT:
						Toast.makeText(Viewshed.this, "TIMED_OUT", Toast.LENGTH_LONG).show();
						break;
					default:						
						break;
					}
				}
			}, 1000, 2000);
		}
    }

以上是本例的关键代码，如需完整代码，请在评论中留下邮箱。