ArcGIS runtime SDK for WPF/Silverlight中的三种常用的查询:QueryTask、FindTask、IdentifyTask都是继承自ESRI.ArcGIS.Client.Tasks,关系如下图所示:
1、QueryTask:是一个进行空间和属性查询的功能类,它可以在某个地图服务的某个子图层内进行查询,顺便提一下的是,QueryTask进行查询的地图服务并不必须加载到Map中进行显示。QueryTask的执行需要两个先决条件:一个是需要查询的图层URL、一个是进行查询的过滤条件。
下面是QueryTask的基本过程:
//新建一个QueryTask QueryTask queryTask = new QueryTask("http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/5"); // Query对象 Query query = new Query(); //传入空间几何范围,可以不设置 //合法的geometry类型是Extent, Point, Multipoint, Polyline, Polygon query.Geometry = geometry; //是否返回查询结果的空间几何信息 query.ReturnGeometry = true; //查询结果返回的字段,字段必须在图层中,字段的大小写可忽略 query.OutFields.AddRange(new string[] { "AREANAME", "POP2000" }); //quer.OutField.Add("*"); //返回所有字段 //查询的where条件,可以是任何合法的SQL语句,可以不设置 query.Where = "POP2000 > 350000"; //异步查询,需要绑定queryTask的两个事件,通过ExecuteCompleted得到查询结果 queryTask.ExecuteCompleted += QueryTask_ExecuteCompleted; queryTask.Failed += QueryTask_Failed; queryTask.ExecuteAsync(query); //同步查询,不需要绑定事件,直接返回查询结果 //FeatureSet featureSet = queryTask.Execute(query);
2、FindTask:允许对地图中一个或多个图层的要素进行基于属性字段值的查询(search one or more layers in a map for features with attribute values that match or contain an input value)。FindTask不能进行“空间查询”,因为FindTask可以对多个图层进行查询,所有它的url属性需要指向所查询的地图服务的REST URL,而不像QueryTask需要指定某个图层的URL。
下面是FindTask的基本过程:
//新建一个Find task FindTask findTask = new FindTask("http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/"); //异步执行,绑定事件 findTask.ExecuteCompleted += FindTask_ExecuteCompleted; findTask.Failed += FindTask_Failed; //初始化FindParameters参数 FindParameters findParameters = new FindParameters(); findParameters.LayerIds.AddRange(new int[] { 3 }); //查找的图层 findParameters.SearchFields.AddRange(new string[] { "NAME" }); //查找的字段范围 findParameters.ReturnGeometry = true; findParameters.SearchText = FindTextBox.Text; //查找的“属性值” //设置查询的LayerDefinitions ESRI.ArcGIS.Client.LayerDefinition myDefinition = new ESRI.ArcGIS.Client.LayerDefinition(); myDefinition.LayerID = 3; //设置LayerDefinition,属性字段“Name”属于ID为0的图层 //LayerDefinition的设置语句和Query中的Where语句一样 myDefinition.Definition = "NAME = 'XXX'"; //创建一个ObservableCollection,add设置的LayerDefinition System.Collections.ObjectModel.ObservableCollection<LayerDefinition> myObservableCollection = new System.Collections.ObjectModel.ObservableCollection<LayerDefinition>(); myObservableCollection.Add(myDefinition); findParameters.LayerDefinitions = myObservableCollection; //设置查询的LayerDefinitions //异步执行 findTask.ExecuteAsync(findParameters);
3、IdentifyTask:是一个在地图服务中识别要素(Feature)的功能类。通过IdentifyTask可以搜索地图层中与输入几何形相交的要素(search the layers in a map for features that intersect an input geometry)。因为也是在多个图层中查询,所以Task的URL是动态图层服务的地址。同样,返回的要素都可以作为Graphic被添加到地图的GraphicsLayer上。
基本过程如下:
//新建一个Identify task IdentifyTask identifyTask = new IdentifyTask("http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer"); //异步执行,绑定事件 identifyTask.ExecuteCompleted += IdentifyTask_ExecuteCompleted; identifyTask.Failed += IdentifyTask_Failed; //初始化 Identify parameters IdentifyParameters identifyParameters = new IdentifyParameters(); identifyParameters.LayerOption = LayerOption.all; //传递地图属性给 identify parameters identifyParameters.MapExtent = MyMap.Extent; identifyParameters.Width = (int)MyMap.ActualWidth; identifyParameters.Height = (int)MyMap.ActualHeight; //输入的几何参数为一个点,args来自点击事件 identifyParameters.Geometry = args.MapPoint; //Point Envelop Extent polyline polygon //设置查询的LayerDefinitions ESRI.ArcGIS.Client.LayerDefinition myDefinition = new ESRI.ArcGIS.Client.LayerDefinition(); myDefinition.LayerID = 3; //设置LayerDefinition,属性字段“Name”属于ID为0的图层 //LayerDefinition的设置语句和Query中的Where语句一样 myDefinition.Definition = "NAME = 'XXX'"; //创建一个ObservableCollection,add设置的LayerDefinition System.Collections.ObjectModel.ObservableCollection<LayerDefinition> myObservableCollection = new System.Collections.ObjectModel.ObservableCollection<LayerDefinition>(); myObservableCollection.Add(myDefinition); identifyParameters.LayerDefinitions = myObservableCollection; //设置查询的LayerDefinitions //异步执行 identifyTask.ExecuteAsync(identifyParameters);
三种查询的返回结果:
QueryTask:返回的是一个FeatureSet。Featureset.features[i]可以加入到GraphicsLayer上显示,也可以通过Attributes属性字段得到属性信息。
FindTask:返回的是一个FindResults数组, FindResults[i].feature可以加入到GraphicsLayer上显示,也可以通过Attributes属性字段得到属性信息。
IdentifyTask:返回的是一个IdentifyResults数组,IdentifyResults[i].feature可以加入到GraphicsLayer上显示,也可以通过Attributes属性字段得到属性信息。