感谢一路走来默默支持和陪伴的你~~~
-------------------欢迎来访,拒绝转载--------------------
一、Rest API基础
ArcGIS 平台提供了丰富的REST风格的web服务,以ArcGIS REST API方式对外提供,我们通过ArcGISREST API可以访问地图服务、要素服务、影像服务、地理处理服务等多种类型的Web服务,这些服务可以来自Portal、online或是Arcgis server。
那么如何使用这些ArcGIS REST API呢?我们可以使用常用的编程语言如javascript等构造http请求,然后解析以json格式返回。简单讲一下使用ArcGIS Server REST 风格调用web服务的过程
(1)构建请求url
首先确定端点:包含服务类型的明确的url地址。
然后确定操作:不同的web服务支持的操作类型不同,如:地图服务可以查找、识别、生成kml等。
其次确定参数:不同的操作需要不同的参数,入请求地图服务需要地图范围参数。
最后确定输出的格式:json、kmz、html等,
综上所构建的url格式为:
http://{ArcGISServer name}/ArcGIS/rest/services/{folder name}/{services name}/{service type}/{option}?{parameter2}={somevalues}&{parameter1}={some values}
(2)提交url请求到ArcGIS Server
(3)接收ArcGIS Server的响应
ArcGISServer处理请求并返回响应到客户端,这个过程分为同步和异步。
Execute task:当同步执行的使用此操作,执行的特点是用户需要等待结果被返回适用于短事务处理任务。
Submit job:适用于异步执行。当被异步提交时,用户可以做其他的事情无须等待结果被加载完成,适用于长事务处理任务。
(4)解析和使用响应
ArcGISServer rest web服务的响应可以是多种格式的,如json、kmz、图片、html等,客户端可以判断响应成功还是失败。
通常,ArcGISDesktop、ArcGISpro等客户端与ArcGIS REST API进行交互,其交互的细节不必关心,但是都是ArcGIS REST API在默默的工作。以上是rest与server交互原理,然而使用ArcGIS javascript API 会集成上述四个步骤,不需要自己完成。
--------------------这是一条华丽丽的分割线---------------------
以GP服务为例:
1. 首先ArcGISREST API可以什么:
(1).列举了可用额工具及输入输出参数的属性。
(2).同步执行。
(3).异步提交。
(4).获取运行时的详细工作信息,包括运行的状态。
(5).使用地图服务将运行的结果进行显示。
(6).通过客户端对返回的结果进行进一步的处理。
-----------------------这是一条华丽丽的分割线-----------------------
以一个已发布并运行成功的gp服务为例:关于该GP服务的制作和发布在往期博客有详解:点我! 再点我!
1.注意地址栏上构建的rest服务地址,回顾上述理论,会更加有心的体会。
2.查看发布的服务目录,了解每一个参数的类型、参数的名称。
3.该服务在发布时勾选了异步执行,所以会有submit Job操作,点击submit job执行。
4.在第一栏中要求输入excel,想必这是每一个人在执行过程中最为头疼的事情,该怎样输入呢?无从下手。
这时,就需要注意参数的类型,gp模型的类型与gp服务的类型存在对应关系,同时GP服务的类型又与ArcGIS javascript API中规定的参数类型存在对应关系,只有准确的找准参数,才可以对这个参数按照api中规定的格式进行构造,参数对应表如下:
很显然,GPDataFile对应javascript中的
5.执行ing,此时你可以观察服务的url,生成的结果在arcgis server所管理的服务目录下,生成了一个唯一文件名的文件夹,其结果将会临时存放在那里。
6.执行成功,会看到esriJobSuccessed!此时,你应该多开森~~
7.点击生成的结果进行预览,应该就是想要的效果了,这个结果可以通过Arcgis javascript API添加到地图上。
-----------------这是一条华丽丽的分割线------------------
本文的参考资料:
http://resources.arcgis.com/EN/HELP/ARCGIS-REST-API/index.html#/Resources_and_operations/02r3000000t9000000/
https://developers.arcgis.com/javascript/jsapi/parametervalue-amd.html
----------------------欢迎来访,拒绝转载----------------------
版权声明:本文为博主原创文章,未经博主允许不得转载。