Silverlight调用GP服务详解
上一篇主要讲了如何发布GP服来绘制等值线及等直面，这里主要将如何通过Silverlight来调用GP服务。
这里先写一下具体的调用过程：
- 声明GP服务变量(Geoprocessor),并实例化
- 注册GP服务任务完成事件及失败事件
- 根据发布的GP服务，定义GP服务的参数
- 输入GP服务参数请求GP服务
- 获取结果：在Compeleted事件函数中完成获取结果的代码，对于是要素类结果，需要注册GetResultDataCompleted事件，对于是栅格数据结果需要注册GetResultImageLayerCompleted事件，然后在事件的回调函数中完成最终结果的获取。
这里需要注意的问题：
a． GP服务是同步调用还是异步调用
b． 获得结果的坐标系是否和当前一致
c． GP服务的输入参数必须和发布的GP服务一致(之后会详细说明)
d． 获取结果的名称必须和发布的GP服务一致(之后会详细讲到)
以上大致的说了一下GP服务调用的基本过程，下面就开始正式的工作吧。
一．基本界面
首先我们构建一个简单的Web界面，如下图所示：
这里需要实现的基本功能是：可以保存每一次添加的Graphic(xml格式)，并能够再次读取这些Graphic.根据加载的Graphic实现基本的预测,即调用GP服务。
说明：为了节省时间，这里我已将用到的点的数据保存成了一个xml文档，所有需要的数据都从xml中读取。
二．加载xml格式的Graphic信息
这里就是遍历xml中所有Graphic节点，然后读取相应的信息(节点的名称根据我们保存xml时定义的不同而不同，后面会给出保存xml的代码)。读取xml信息的代码如下：
View Code
1 //打开加载数据对话框 2 OpenFileDialog openFileDialog = new OpenFileDialog(); 3 //指定xml问价格式 4 openFileDialog.Filter = "XML Files(*.xml)|*.xml"; 5 if (openFileDialog.ShowDialog() == true) 6 { 7 using (Stream stream = openFileDialog.File.OpenRead()) 8 { 9 XDocument doc = XDocument.Load(stream); 10 //遍历xml中的Graphic节点 11 foreach (XElement element in doc.Descendants("Graphic")) 12 { 13 //遍历Graphic节点下的Location节点 14 foreach (XElement LocationElement in element.Descendants("Location")) 15 { 16 //获得Location节点下的坐标 17 double LocationX = Convert.ToDouble(LocationElement.Element("LocationX").Value); 18 double LocationY = Convert.ToDouble(LocationElement.Element("LocationY").Value); 19 //获得Graphic节点下的浓度值 20 double PollutionC = Convert.ToDouble(element.Element("PolutionC").Value); 21 //绘制Graphic 22 CreatGraphic(LocationX, LocationY, PollutionC); 23 } 24 } 25 } 26 }
CreatGraphic方法表示在地图上根据获得的坐标和浓度值绘制出一个点。
View Code
//定义一个图层，所以的Graphic将在此图层上绘制 private GraphicsLayer graphicsLayer = null; private void CreatGraphic(double locationx, double locationy, double pollutionc) { //构建一个Graphic,并定义其样式 Graphic g = new Graphic() { Geometry = new MapPoint() { X=locationx, Y=locationy, SpatialReference=map.SpatialReference }, Symbol = new SimpleMarkerSymbol() { Size = 9, Color = new SolidColorBrush(Colors.Blue), Style = SimpleMarkerSymbol.SimpleMarkerStyle.Circle }, }; if (map.Layers["GraphicsPoints"] == null) { graphicsLayer = new GraphicsLayer() { ID = "GraphicsPoints" }; map.Layers.Add(graphicsLayer); } //添加浓度属性 g.Attributes.Add("PolutionC", pollutionc); // graphicsLayer.Graphics.Add(g); }
三．保存xml格式的Graphic信息
这里我们将GraphicLayer上所有的点的信息保存成xml格式。需要注意的是，xml中节点名称必须和读取xml文件时使用的节点名保持一致。否则之后我们无法读取我们保存的信息。具体代码如下：
View Code
1 //若要素图层不存在则返回 2 if (map.Layers["GraphicsPoints"] == null) 3 return; 4 //若图层要素为空也返回 5 GraphicsLayer graphicslayer = map.Layers["GraphicsPoints"] as GraphicsLayer; 6 if (graphicslayer.Graphics.Count <= 0) 7 return; 8 //打开保存对话框 9 SaveFileDialog saveFileDialog = new SaveFileDialog(); 10 //指定xml文件格栅 11 saveFileDialog.DefaultExt = "xml"; 12 saveFileDialog.Filter = "XML Files (*.xml)|*.xml"; 13 //指定默认的文件名为当前的时间 14 saveFileDialog.DefaultFileName = string.Format("GraphicInfo{0}", GetCurrentDateTimeString()); 15 16 if (saveFileDialog.ShowDialog() == true) 17 { 18 using (Stream stream = saveFileDialog.OpenFile()) 19 { 20 StreamWriter streamWriter = new StreamWriter(stream, System.Text.Encoding.UTF8); 21 int GraphicNum = 1; 22 23 foreach (Graphic g in graphicslayer.Graphics) 24 { 25 //调用自定义GetGeneratedXML方法，构建xml 26 GetGeneratedXML(GraphicNum, g); 27 GraphicNum++; 28 } 29 streamWriter.Write(doc.ToString()); 30 streamWriter.Close(); 31 stream.Close(); 32 } 33 }
GetGeneratedXML方法代码如下：
View Code
1 private void GetGeneratedXML(int graphicID, Graphic g) 2 { 3 MapPoint mapPoint = g.Geometry as MapPoint; 4 XElement graphic = new XElement("Graphic", new XAttribute("ID", graphicID), 5 new XElement("Location", 6 new XElement("LocationX", mapPoint.X), 7 new XElement("LocationY", mapPoint.Y)), 8 new XElement("PolutionC", Convert.ToDouble(g.Attributes["PolutionC"]))); 9 doc.Root.Add(graphic); 10 }
GetCurrentDateTimeString方法如下：
View Code
1 private string GetCurrentDateTimeString() 2 { 3 string TimeString; 4 DateTime CurrentTime = new DateTime(); 5 CurrentTime = System.DateTime.Now; 6 int year = CurrentTime.Year; 7 int month = CurrentTime.Month; 8 int day = CurrentTime.Day; 9 int hour = CurrentTime.Hour; 10 int minute = CurrentTime.Minute; 11 int second = CurrentTime.Second; 12 TimeString = string.Format("{0}{1}{2}{3}{4}{5}", year, month, day, hour, minute, second); 13 return TimeString; 14 }
四．根据添加的点，进行预测及可视化表达(绘制等值线及等值面)
到这里为止，才算是真正开始我们的GP服务。具体的调用过程在开始的时候作了一个大致的介绍，下面开始详细的讲解。
4.1 定义GP服务变量
View Code
1 //定义GP服务变量 2 private Geoprocessor InterpolationTask = null;//绘制等值面 3 private Geoprocessor ContourTask = null;//绘制等值线
并且实例化GP服务变量,并注册相应的事件
View Code
1 //等值线GP服务 2 ContourTask = new Geoprocessor("http://qzj-pc/ArcGIS/rest/services/ContourService_with_Focal_Statistics/GPServer/ContourService"); 3 ContourTask.JobCompleted += new EventHandler<JobInfoEventArgs>(ContourTask_JobCompleted); 4 ContourTask.GetResultDataCompleted += new EventHandler<GPParameterEventArgs>(ContourTask_GetResultDataCompleted); 5 ContourTask.Failed += new EventHandler<TaskFailedEventArgs>(ContourTask_Failed); 6 //等值面GP服务 7 InterpolationTask = new Geoprocessor("http://qzj-pc/ArcGIS/rest/services/InterpolationService_Stretch/GPServer/InterpolationModel"); 8 InterpolationTask.JobCompleted += new EventHandler<JobInfoEventArgs>(InterpolationTask_JobCompleted); 9 InterpolationTask.GetResultImageLayerCompleted += new EventHandler<GetResultImageLayerEventArgs>(InterpolationTask_GetResultImageLayerCompleted); 10 InterpolationTask.Failed += new EventHandler<TaskFailedEventArgs>(InterpolationTask_Failed);
4.2 定义GP服务的请求参数
这里需要的参数必须和我们发布的GP服务一致。我们打开绘制等值线的GP服务链接，基本参数如下所示：
以上是绘制等值面的GP服务参数列表，并给出了参数信息的详细说明，这里我们可以看出绘制等值面的GP服务只有一个输入参数：PollutionPoints，类型是GPFeatureRecordSetLayer,也就是要素集。同时只有一个输出参数：RasterData,类型是GPRasterDataLayer,即栅格数据。
下面我们定义绘制等值面的GP服务参数。
1 //添加这段代码，非常有用，否则将无法获取GP服务的结果 2 HttpWebRequest.RegisterPrefix("http://", System.Net.Browser.WebRequestCreator.ClientHttp); 3 //将从xml中解析出来的点构建成要素集，并作为我们GP服务输入的参数 4 FeatureSet featureSet = new FeatureSet(graphicsLayer.Graphics); 5 //定义GP服务参数：InterpolationJobParameter 6 List<GPParameter>InterpolationJobParameter = new List<GPParameter>(); 7 //添加GP服务参数 8 InterpolationJobParameter.Add(new GPFeatureRecordSetLayer("PollutionPoints", featureSet)); 9 //请求等直面GP服务 10 InterpolationTask.SubmitJobAsync(InterpolationJobParameter);
注意这里的PollutionPoints，这里的名称必须和之前我们发布的GP服务参数列表一致。而且还需要注意这里的GP服务参数类型，必须是要素集。
同理，我们可以看看绘制等值线的GP服务参数列表,如下图所示：
后台定义的绘制等值线的GP服务参数代码：
1 //定义绘制等值线的GP服务参数 2 List<GPParameter> ContourJobParameter = new List<GPParameter>(); 3 //添加要素集参数 4 ContourJobParameter.Add(new GPFeatureRecordSetLayer("PollutionPoints", featureSet)); 5 //添加等值线间距参数 6 ContourJobParameter.Add(new GPDouble("Contour_interval", 4.0001)); 7 //添加容差设置参数 8 ContourJobParameter.Add(new GPLinearUnit("XY_Tolerance", esriUnits.esriMeters, 1)); 9 //请求等值线GP服务 10 ContourTask.SubmitJobAsync(ContourJobParameter);
注意上面的GP服务参数名称必须保持一致。
五.获取GP服务的结果，并在地图上显示
之前说过，请求GP服务结果都会有一个Completed事件，所以我们获取结果的代码将在该事件回调函数中完成。之前我们已注册了GP事件，其回调函数如下：
下面我们就开始获取等值面的结果。
在请求等值面GP服务的完成事件中添加如下代码：
1 private void InterpolationTask_JobCompleted(object sender, JobInfoEventArgs e) 2 { 3 4 if (e.JobInfo.JobStatus == esriJobStatus.esriJobFailed) 5 { 6 MessageBox.Show("请求服务失败！" + e.JobInfo.Messages.ToString()); 7 return; 8 } 9 HttpWebRequest.RegisterPrefix("http://", System.Net.Browser.WebRequestCreator.ClientHttp); 10 //获取GP服务结果，这里需要注意的是结果的名称必须和我们发布的GP服务参数列表一致 11 InterpolationTask.GetResultImageLayerAsync(e.JobInfo.JobId, "RasterData"); 12 }
注意这里的RasterData必须和之前我们发布的GP服务输出参数名称一致，否则将无法获取到结果。
这里我们注意到，GetResultImageLayerAsync也是一个异步请求，因此我们需要在其完成事件的回调函数中获得最终的结果，之前我们已经注册了其完成的事件函数，现在添加如下代码：
1 private void InterpolationTask_GetResultImageLayerCompleted(object sender, GetResultImageLayerEventArgs e) 2 { 3 //返回的结果实际上是一张图片 4 GPResultImageLayer imagelayer = e.GPResultImageLayer; 5 //定义图层的ID 6 imagelayer.ID = "InterpolationLayer"; 7 //设置透明度 8 imagelayer.Opacity = 0.7; 9 //清空原有的结果 10 if (map.Layers["InterpolationLayer"] != null) 11 { 12 map.Layers.Remove(map.Layers["Interpolation"]); 13 } 14 //添加当前结果到图层中 15 map.Layers.Add(imagelayer); 16 MessageBox.Show("绘制完成！"); 17 }
这里说明一点：由于栅格数据不支持在Web客户端直接读取，因此我们通过结果地图服务，将其在服务器端根据我们设置的渲染格式，生成一张图片。然后在客户端实际上是获取这张图片，而不是栅格数据，当客户端的地图范围发生改变时(移动，缩放)，就会在服务器端动态的生成响应的图片，并在Web客户端显示其相应的结果。
最后，你还可以在Failed事件中添加GP服务请求失败时的相应处理。
private void InterpolationTask_Failed(object sender, TaskFailedEventArgs e) { MessageBox.Show("请求服务失败:" + e.Error.ToString()); }
以上的过程便是获取GP绘制等直面的结果。
下面是获得的结果：
点击加载xml文档，打开xml文件，就会添加相应的Graphic,如下图所示：
接着点击预测，结果如下：
接下来，我们看看如何获取等值线的结果。其过程和等值面的获取相似，只不过等值线的结果是线要素，而等值面则是一张图片，两则在获取和显示上有一点点的差别。
下面是绘制等值线GP请求的Completed事件响应函数代码，和等值面的差不多，唯一不同的就是异步请求的函数，以及阐述不一样。
1 private void ContourTask_JobCompleted(object sender, JobInfoEventArgs e) 2 { 3 if (e.JobInfo.JobStatus == esriJobStatus.esriJobFailed) 4 { 5 MessageBox.Show("请求等值线服务失败：" + e.JobInfo.Messages); 6 return; 7 } 8 HttpWebRequest.RegisterPrefix("http://", System.Net.Browser.WebRequestCreator.ClientHttp); 9 //请求绘制等值线GP服务，注意这里和等值面的异步请求函数不一样 10 ContourTask.GetResultDataAsync(e.JobInfo.JobId, "ContourLine_shp"); 11 }
同样需要注意请求结果的参数必须和发布的等值线GP服务输出参数名称一致。
然后我们在GetResultDataCompleted事件响应函数中添加相应的代码获取结果，并在地图上显示出来。代码如下：
1 private void ContourTask_GetResultDataCompleted(object sender, GPParameterEventArgs e) 2 { 3 if (map.Layers["ContourLayer"] != null) 4 { 5 map.Layers.Remove(map.Layers["ContourLayer"]); 6 } 7 GraphicsLayer contourLayer = new GraphicsLayer() { 8 ID="ContourLayer" 9 }; 10 11 GPFeatureRecordSetLayer featureSetLayer = e.Parameter as GPFeatureRecordSetLayer; 12 //遍历结果获取其中包含的要素，并添加到等值线图层中 13 foreach (Graphic graphic in featureSetLayer.FeatureSet.Features) 14 { 15 //设置等值线的样式 16 graphic.Symbol = new SimpleLineSymbol() 17 { 18 Style = SimpleLineSymbol.LineStyle.Solid, 19 Color = new SolidColorBrush(Colors.Blue), 20 Width = 3 21 }; 22 contourLayer.Graphics.Add(graphic); 23 } 24 //将结果添加到当前的地图中 25 map.Layers.Add(contourLayer); 26 MessageBox.Show("等值线绘制完成！"); 27 }
同理添加GP服务请求失败处理函数：
private void ContourTask_Failed(object sender, TaskFailedEventArgs e) { MessageBox.Show("请求等值线服务失败：" + e.Error.ToString()); }
这样获取等值线结果的工作已经完成，下面看一看效果：
到此，关于Silverlight调用GP服务绘制等值线以及等值面的所有过程已经讲述完毕。
(版权所有，转载请标明出处)