Silverlight调用GP服务第二篇之调用GP服务(Geoprocessing Service)过程详解

 

 

Silverlight调用GP服务详解

上一篇主要讲了如何发布GP服来绘制等值线及等直面，这里主要将如何通过Silverlight来调用GP服务。

这里先写一下具体的调用过程：

1. 声明GP服务变量(Geoprocessor),并实例化
2. 注册GP服务任务完成事件及失败事件
3. 根据发布的GP服务，定义GP服务的参数
4. 输入GP服务参数请求GP服务
5. 获取结果：在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服务绘制等值线以及等值面的所有过程已经讲述完毕。

 

(版权所有，转载请标明出处)