AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

ArcGIS API for Silverlight开发入门（5）：任务外包——Tasks

2017-11-16 1393
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介：
通过上一节的学习，我们已经知道了如何与GraphicLayer交互，但毕竟GIS不是一个画板，所以这节来看一下如何通过Silverlight API完成GIS中的分析功能。
        GIS之所以是一个通用的工具，就是因为它具有各种各样分析和处理数据的能力。Silverlight API中提供了Task，使我们能够轻松完成常见的分析任务。
        先来考虑一下吃饺子的场景。要想吃饺子，我们需要先去买菜，买肉，回家后在厨房里洗菜，揉面， 拌馅，包饺子，煮饺子，吃饺子，之后别忘了洗碗；另一种情况就是去饭馆，告诉服务员我要吃3两茴香，3两韭菜的饺子，然后等着饺子端到你面前，开吃，走人。
        在ArcGISServer程序开发中，要完成GIS的分析功能其实和吃饺子是一样的。用ADF编程就像在家里吃饺子，除了架设服务器，所有的工作基本上也都得我们自己在服务器端来完成，要处理的地方比较多；而用客户端API编程相当于去外面吃饺子，我们只要把任务交给相应的Task，之后接受结果就行了，不用做饺子。唯一不同的就是在外面吃完饺子别忘了付钱，而用Task完成分析任务则是免费的。这点也体现在使用客户端API中的Task时，是由ArcGISOnline提供给你的，不需要自己购买AGS软件。
        现在来看看Silverlight API目前给我们提供了那些Task功能：
Query：能够在已经发布的服务数据中，通过属性条件（可以属性字段中进行关系判断，字符查找等），图形条件（与输入的图形相交、包含、相离等），或者是两者的组合，查询出满足条件的数据并返回。相当于Engine中的SpatialFilter，当然也是QueryFilter。
Find：在地图数据的属性字段中查找包含有关键字参数的数据并返回。
Identity：对鼠标当前点击位置上的数据进行辨识并返回结果，可以对多个图层的数据进行辨识。
Address Locator：输入经纬度，返回地址结果（Geocoding）；输入一个地方的地址，返回经纬度结果（Reverse Geocoding）。由于国内地图数据保密工作做的相当好，这个Task暂时用不到。
Geometry Service：可以对输入的地理数据进行如缓冲区，动态投影，面积/周长量算等几何操作。
Geoprocessing：能够完成复杂的GIS任务，类似ToolBox中的工具。
        抽象一下，可以看出，Query完全可以完成Identity和Find的工作，但后两者在特定场合下使用起来比Query要方便的多；Geoprocessing完全可以替代Geometry Service，但是在利用REST API编写的程序中，要尽量使用GeometryService。
        再抽象一下，Silverlight API中的这几个Task和JavaScript/FlexAPI中的Task是大同小异的，因为其实它们都是AGS 9.3 REST API中暴露出来的操作资源（OperationResource）见下图：

res-ops.jpg


 


        后面的代码中实际上也是把输入参数封装起来提交到了REST API的特定Endpoint上。要理解好客户端API中的Task，建议熟读AGS的 REST SDK。
        Task的用法基本上相同，都遵循这几个步骤：初始化Task，设置Task所需参数，提交任务，等待服务器完成任务后，处理返回的结果；进饭馆，想好你要吃什么饺子，告诉服务员，等饺子做好端上来，开始吃。好了，下面我们就通过一个实例（ 点击这里，查看实例），来学习一下Query和Geometry两个Task的用法。

05_results.jpg


 



        首先选择工具条中的画线工具，在屏幕上画一条曲线，会根据曲线自动生成一个距离100公里的缓冲区显示在地图上，之后开始查询缓冲区图形经过的州（相交），将结果显示在地图上。可以单击每个州查看详细信息。这里假设你已学习了前几节的内容，只讨论Task用法的部分。
1、利用所画的线生成缓冲区。画线利用的是Draw工具中的Freehand，在这个动作完成后会触发Draw的OnDrawCompleted事件，自然可以在这里开始进行缓冲区的工作，用的是Geometry Service里的Buffer。
        初始化Geometry Service。假设已经在Map1中添加了ID为glayerResult的GraphicsLayer，linesymbolred是提前设置好的CartographicLineSymbol：
  1. private void Draw1_OnDrawComplete(object sender, DrawEventArgs args)
  2. {
  3. Draw1.Deactivate();//Freehand动作失效
  4. //将Freehand画的曲线显示在地图上
  5. GraphicsLayer glayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  6. Graphic g = new Graphic();
  7. g.Symbol = linesymbolred;
  8. g.Geometry = args.Geometry;
  9. glayer.Graphics.Add(g);
  10. //初始化Geometry Service
  11. GeometryService geometrytask = new GeometryService("http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Geometry/GeometryServer");
  12. }
复制代码
GeometryService的初始化使用构造函数来完成的，里面接受一个URL，这个是Geometry Service的REST APIEndpoint。顺便说一下，不同于其他服务比如MapService，一个GISServer只能发布一个GeometryService，并且它的名称必须是Geometry。
        当一个Task完成时会触发Completed事件，失败时也有Failed事件，对这两个事件进行监听：
  1. geometrytask.BufferCompleted += new EventHandler(geometrytask_BufferCompleted);
  2. geometrytask.Failed += new EventHandler(geometrytask_Failed);
复制代码
设置Buffer操作所需的参数：
  1. BufferParameters bufferparameters = new BufferParameters();
  2. bufferparameters.Unit = LinearUnit.Kilometer;
  3. //必须指定下面两个spatialreference，否则buffer结果集为空
  4. bufferparameters.BufferSpatialReference = new SpatialReference(3395);
  5. bufferparameters.OutSpatialReference = Map1.SpatialReference;
  6. bufferparameters.Distances.Add(100);
  7. bufferparameters.Features.Add(g);
复制代码
BufferParameters是专门用于Buffer的参数；BufferSpatialReference是将要Buffer的图形重新投影到这个坐标系下（常常需要根据地图数据所在地方的情况来设置这个参数），并设置Buffer距离的单位为公里，Buffer的输出一般与地图坐标系一致；Buffer参数有一个Features属性，是List类型，里面的Graphic都将被Buffer。下来将Buffer的任务提交到服务器（可以看出为什么这些动作要叫Task）：
  1. geometrytask.BufferAsync(bufferparameters);
复制代码
以上代码都放在Draw1_OnDrawComplete函数中。任务提交到服务器后，由GeometryService接管，计算，完成后会立刻将结果返回给我们，通知我们结果已经完成的方式就是前面绑定的Completed事件。接收到结果后，首先将缓冲区显示出来：
  1. private void geometrytask_BufferCompleted(object sender, GraphicsEventArgs args)
  2. {
  3. if (args.Results.Count>0)
  4. {
  5. GraphicsLayer glayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  6. Graphic g = new Graphic();
  7. g.Symbol = fillsymbolBuffer;
  8. g.Geometry = args.Results[0].Geometry;
  9. glayer.Graphics.Add(g);
  10. }
  11. }
复制代码
如图：

05_buffer.jpg


 


2、利用生成缓冲区的缓冲区进行空间查询。要达到我们的目的，就还需要进行一个Query的Task，那么就可以在这里马不停蹄的开始Query的Task。步骤基本都是一样的，初始化，设置参数，提交结果，处理结果：
  1. private void geometrytask_BufferCompleted(object sender, GraphicsEventArgs args)
  2. {
  3. if (args.Results.Count>0)
  4. {
  5. GraphicsLayer glayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  6. Graphic g = new Graphic();
  7. g.Symbol = fillsymbolBuffer;
  8. g.Geometry = args.Results[0].Geometry;
  9. glayer.Graphics.Add(g);
  10. //初始化QueryTask
  11. QueryTask querytask = new QueryTask("http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/5");
  12. //准备接收结果或者处理失败的通知
  13. querytask.ExecuteCompleted += new EventHandler(querytask_ExecuteCompleted);
  14. querytask.Failed += new EventHandler(querytask_Failed);
  15. //设置Query Task所需的参数
  16. Query query = new Query();
  17. query.OutFields.Add("*");//也顺便设置了query.ReturnGeometry=true;
  18. query.Geometry = g.Geometry;
  19. query.SpatialRelationship = SpatialRelationship.esriSpatialRelIntersects;
  20. //向服务器上的对应图层提交任务
  21. querytask.ExecuteAsync(query);
  22. Map1.Cursor = System.Windows.Input.Cursors.Wait;
  23. }

  25. }
复制代码
这里的查询实在美国州的图层上进行的，详细信息将QueryTask构造函数里的那个参数输入浏览器查看；query.Geometry是设置需要进行空间查询的图形，就是上面缓冲区的结果；OutFields是查询结果需要返回的字段，这里返回全部字段，如果返回全部字段，则强制设置了ReturnGeometry为true，如果我们不需要处理结果的图形信息，则可以将这个参数设为false，以节省流量，显然这里不是；空间关系可以参考API，与Engine中的完全一致。
        接下来处理QueryTask完成后的结果：
  1. private void querytask_ExecuteCompleted(object sender, QueryEventArgs args)
  2. {
  3. GraphicsLayer graphicslayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  4. FeatureSet featureset = args.FeatureSet;
  5. if (featureset != null && featureset.Features.Count > 0)
  6. {
  7. graphicslayer.ClearGraphics();
  8. listboxResults.Items.Clear();
  9. foreach (Graphic graphic in featureset.Features)
  10. {
  11. graphic.Symbol = fillsymbolresult;
  12. graphicslayer.Graphics.Add(graphic);
  13. }
  14. }
  15. MyMapTip.GraphicsLayer = graphicslayer;
  16. Map1.Cursor = System.Windows.Input.Cursors.Arrow;
  17. }
复制代码
上面处理空间查询的结果只是将图形显示了出来，那么对于单击某个州后，显示出其详细信息该怎么办呢？从图一可以看出，用到了Silverlight的DataGrid控件，信息从哪里去呢？记得上面我们设置结果中返回的全部属性字段吗？它们存储在每个Graphic的Attributes属性中。要么绑定到DataGrid里，要么一条条添加……你可能已经发现了这条语句MyMapTip.GraphicsLayer =graphicslayer;，还记得第三节的Widgets吗？那里我们落下了MapTip这个小家伙，现在派上用场了。除了在这里设置MapTip的GraphicsLayer属性外，在xaml中有如下的定义：
  1. <esriWidgets:MapTip x:Name="MyMapTip" BorderBrush="#99000000"
  2. BorderThickness="1" Title="详细信息" VerticalOffset="10"
  3. HorizontalOffset="10" Background="#DDFFFFFF" />
复制代码
仅此而已。MapTip会自动找寻自己GraphicsLayer中的Graphic，当鼠标悬停在某个Grpahic上时，会自动读取它的Attributes属性并显示，小玩具又发挥了大作用。
        别忘了万一处理任务失败时的提示：
  1. private void geometrytask_Failed(object sender, TaskFailedEventArgs args)
  2. {
  3. MessageBox.Show("Buffer Error:" + args.Error);
  4. }

  6. private void querytask_Failed(object sender, TaskFailedEventArgs args)
  7. {
  8. MessageBox.Show("Query failed: " + args.Error);
  9. Map1.Cursor = System.Windows.Input.Cursors.Arrow;
  10. GraphicsLayer graphicslayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  11. graphicslayer.ClearGraphics();
  12. }
复制代码

本节内容完毕。上面讲的相对简略，要理解各个Task和参数的用法，还是需要熟悉Silverlight API和前面提到的REST API。另外，Geoprocessing Service实际上是最强大Task，如果有自己的GISServer，完全可以在上面发布自制的Model或者Python脚本，以完成各种GIS分析任务，简单的在线编辑也是可能的。它的用法也万变不离其宗：初始化，设置参数，提交任务，处理结果。不同的是GeoprocessingService有两种提交任务的方法：同步和异步。前者服务器端处理完任务后会立即将结果发送回客户端；后者将任务提交后会得到服务器端返回的一个JobID，即使任务处理完成也不会立即返回，而是需要你拿这个JobID去询问服务器：完成了吗？完成了吗？完成了吗？如果完成，则可以取回相应的结果。
        前面说到，虽然去外面吃饺子很方便，但是毕竟那是人家做好的，对于老饕来说还需要自己的口感，自己下厨毕竟能控制整个过程的方方面面，哪怕你想做出饺立方也都是有可能的。同样，ADF编程可以调用服务器端的ArcObjects，让你为所欲为，这点是客户端API无论如何也办不到的。
原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-45302-1-1.html

 

 

本文转自温景良(Jason)博客园博客，原文链接：http://www.cnblogs.com/wenjl520/archive/2009/06/02/1494144.html，如需转载请自行联系原作者

文章标签：
API
定位技术
网络架构
JavaScript
Python
前端开发
开发工具
存储
关键词：
API开发
API任务
API入门
API开发入门
API开发任务
科技小毛
目录
相关文章
shuj
|
5天前
|
前端开发 API 数据处理
探索后端开发中的API设计哲学
【9月更文挑战第10天】在数字化时代的浪潮下，后端开发作为连接数据与前端界面的桥梁，其重要性不言而喻。本文将深入探讨如何通过精心设计的API来提升后端服务的可维护性、扩展性和用户体验。我们将从API设计的基本原则出发，逐步展开对RESTful API和GraphQL两种流行风格的比较分析，并结合具体场景讨论最佳实践。文章旨在为开发者提供一套实用的API设计指南，助力打造高效、稳定且易于协作的软件架构。
shuj
19 6
爱的不是纯牛奶-47754
|
4天前
|
API 网络架构 微服务
探索 GraphQL：现代 API 开发的新范式
GraphQL 是一种高效的 API 查询语言，允许客户端精确请求所需数据，避免了传统 RESTful API 中的数据冗余问题。它由 Facebook 开发并开源，现广泛应用于现代 Web 和移动应用。本文将介绍 GraphQL 的核心概念、优势及其在不同场景下的应用，并指导你如何构建和优化 GraphQL API。
爱的不是纯牛奶-47754
16 4
肥猪肥猪-17824
|
7天前
|
JavaScript 测试技术 API
探索后端开发：构建高效API的艺术
【9月更文挑战第8天】本文旨在揭示后端开发中一个经常被忽视的领域——API设计。通过深入浅出的方式，我们将探讨如何构建一个既高效又易于维护的API。文章将涵盖设计原则、最佳实践以及一些常见的陷阱和解决方案。无论你是初学者还是有经验的开发者，这篇文章都将为你提供宝贵的见解和实用的技巧，帮助你在后端开发的道路上更进一步。
肥猪肥猪-17824
23 6
1592440288735793
|
7天前
|
前端开发 API 开发者
深入浅出：后端开发中的API设计艺术
在数字化时代的浪潮中，后端开发如同搭建一座座数据桥梁，连接着用户与服务的无限可能。而API设计，则是这座桥梁的精髓所在。本文将带领读者领略API设计的艺术，从基础原则到进阶实践，探索如何打造高效、稳定且易于使用的后端接口。无论你是初学者还是资深开发者，这篇文章都将为你打开一扇通往高质量后端开发的大门。
1592440288735793
20 3
游客qf4jmczx4xu2y
|
6天前
|
存储 安全 API
探索后端开发：构建高效API的艺术
【9月更文挑战第9天】在数字时代的浪潮中，后端开发如同一位默默无闻的艺术家，精心雕琢着每一个数据交互的细节。本文将带你走进后端的世界，从基础概念到实战技巧，一起学习如何打造高效、稳定且易于扩展的API。我们将通过深入浅出的方式，探讨后端开发的哲学与实践，让你在编码之旅中，找到属于自己的节奏和和谐。让我们一起跟随代码的脚步，解锁后端开发的无限可能。
游客qf4jmczx4xu2y
13 1
请看我回答~
|
10天前
|
XML JSON 缓存
探索后端开发中的RESTful API设计原则
【9月更文挑战第5天】在数字化时代的浪潮中，后端开发扮演着支撑整个互联网世界运行的基石角色。而作为连接前端与后端桥梁的RESTful API，其设计质量直接影响到应用的性能和用户体验。本文将深入探讨RESTful API的设计原则，通过浅显易懂的语言和实际代码示例，引导读者理解如何构建高效、易于维护的API。无论你是初学者还是有经验的开发者，这篇文章都将为你提供新的视角和思考。
请看我回答~
33 4
东方睿赢
|
10天前
|
缓存 Java 应用服务中间件
随着微服务架构的兴起，Spring Boot凭借其快速开发和易部署的特点，成为构建RESTful API的首选框架
【9月更文挑战第6天】随着微服务架构的兴起，Spring Boot凭借其快速开发和易部署的特点，成为构建RESTful API的首选框架。Nginx作为高性能的HTTP反向代理服务器，常用于前端负载均衡，提升应用的可用性和响应速度。本文详细介绍如何通过合理配置实现Spring Boot与Nginx的高效协同工作，包括负载均衡策略、静态资源缓存、数据压缩传输及Spring Boot内部优化（如线程池配置、缓存策略等）。通过这些方法，开发者可以显著提升系统的整体性能，打造高性能、高可用的Web应用。
东方睿赢
33 2
taro_秋刀鱼
|
1月前
|
机器人 API Python
智能对话机器人(通义版)会话接口API使用Quick Start
本文主要演示了如何使用python脚本快速调用智能对话机器人API接口，在参数获取的部分给出了具体的获取位置截图，这部分容易出错，第一次使用务必仔细参考接入参数获取的位置。
taro_秋刀鱼
88 1
技术交流18179014480
|
17天前
|
存储 JSON API
淘系API接口（解析返回的json数据）商品详情数据解析助力开发者
——在成长的路上，我们都是同行者。这篇关于商品详情API接口的文章，希望能帮助到您。期待与您继续分享更多API接口的知识，请记得关注Anzexi58哦！ 淘宝API接口（如淘宝开放平台提供的API）允许开发者获取淘宝商品的各种信息，包括商品详情。然而，需要注意的是，直接访问淘宝的商品数据API通常需要商家身份或开发者权限，并且需要遵循淘宝的API使用协议。
技术交流18179014480
40 5
淘系API接口（解析返回的json数据）商品详情数据解析助力开发者
wljslmz
|
27天前
|
SQL 存储 数据处理
深入探索GBase 8a MPP集群的C-API开发接口
【8月更文挑战第20天】
wljslmz
43 2

热门文章

最新文章

  • 1
    一起谈.NET技术，Silverlight与PostgreSQL数据库的互操作(CURD完全解析)
  • 2
    Silverlight中样式使用方式
  • 3
    一起谈.NET技术，部署Silverlight及Web Service
  • 4
    Silverlight实用窍门系列：10.动态生成DataGrid,动态绑定DataGrid模板列【附带实例源码】
  • 5
    Silverlight动态设置WCF服务Endpoint
  • 6
    一步一步学Silverlight 2系列（9）：使用控件模板
  • 7
    SilverLight-DataBinding：二、Bingding to a Collection Objects(绑定一个集合对象)
  • 8
    稳扎稳打Silverlight(24) - 2.0通信之Socket, 开发一个多人聊天室
  • 9
    Silverlight 的导航框架与动态加载
  • 10
    36.Silverlight中播放视频和打印文档【附带源码实例】
  • 1
    2024最新ArcGIS Pro 3.0.2 官方原版简体中文直装版
    188
  • 2
    ArcGIS Pro遥感影像分类：随机森林、支持向量机方法
    318
  • 3
    ArcGIS面要素最小外接矩形、外接圆的绘制方法
    77
  • 4
    ArcGIS手动分割矢量面要素从而划分为多个面部分的方式：Cut Polygons Tool
    129
  • 5
    ArcGIS导出AI或EPS格式的地图图片并在Adobe Illustrator中继续编辑
    250
  • 6
    ArcGIS批量拼接大量栅格遥感影像：Mosaic工具
    207
  • 7
    ArcGIS中ArcMap创建渔网Create Fishnet：生成指定大小的格网矢量文件
    166
  • 8
    ArcGIS中ArcMap栅格图像平滑滤波：焦点统计、滤波器、重采样
    223
  • 9
    ArcGIS中ArcMap分割栅格Split Raster工具没有结果的解决
    162
  • 10
    ArcGIS中ArcMap栅格重采样操作与算法选择
    166

    • 相关课程

    更多
  • Cloud Toolkit 开发部署效率提升神器

    • 相关电子书

    更多
  • Spring Boot2.0实战Redis分布式缓存
  • CUDA MATH API
  • API PLAYBOOK

    • 相关实验场景

    更多
  • Internet Information Services（IIS）部署Web项目
  • Web Terminal环境使用指南
  • 前端开发基础2：VS Code和Edge的联动开发
  • 快速体验智能体API应用
  • 基于Assistant Api的旅游助手
    • 下一篇
    基于LNMP搭建WordPress