撰写日期：2019年12月11日
注意：随着时间推移，该博文可能不再适用，请仔细检查自己的版本与博文版本的对应关系，不能保证三五年后，该博文仍然对新版本的ArcGIS API for Javascript 4.13有效！

---

ArcGIS API for Javascript 3.x系列的调用方式和4.x系列的调用方式，有些地方区别还是很大。调用GP服务时的一些3.x版本的代码，在4.x下很多都不能正常运行。

网上的大部分GP服务返回的都是矢量数据，本文的例子将讨论返回栅格数据的GP服务。GP服务的调用有两种方式：（1）同步调用；（2）异步调用
同步调用适合于耗时较少的地理处理，异步调用适用于耗时较多的地理处理。

一、系统环境

• Windows 10 企业版 1903 64bit
• IIS （web服务器）
• ArcGIS Desktop 10.2.2
• ArcGIS Server 10.2.2
• ArcGIS API for Javascript 4.13

二、需要注意的问题

2.1 GP服务的调用地址

• 调用地图服务、要素服务、影像服务时，调用地址是点击该服务，进入后点击功能，复制下面的REST URL地址即可。也就是走到Step 2就可以了。

• 但是，对于GP服务，还需要点击REST URL地址进入详细信息页面（Step 3），此时浏览器中的地址才是GP服务调用地址。也就是要走到Step 3，才是我们的真是调用地址。

GP服务调用地址

2.2 GP服务的参数RasterData

GP服务的参数是接收RasterData，也就是tif格式的影像。这种情况下，栅格影像（.tif格式）需要上传到web服务器中。
例如web服务的根目录是D:\TempOutput\webGIS，B3.tif和B4.tif在webGIS目录下，那么访问这两个文件就可以采用http://localhost/B3.tif和http://localhost/B4.tif。

影像位置

2.3 调用异步GP服务时的参数

如下：输入两个栅格图层B3和B4，计算其植被指数NDVI。
在ArcGIS API for Javascript 4.13版本中，代码如下：

// 4.13版本中用这种
var params = {
    b4: { url: "http://localhost:8082/b4.tif", format: "tif" },
    b3: { url: "http://localhost:8082/b3.tif", format: "tif" },
};
console.log(params);
//发布地理服务(GP服务)时，请务必勾选【View results with a map service】
//中文版本，请务必勾选【查看含地图服务的结果】
//请参考：https://www.cnblogs.com/sguozeng/articles/6423298.html
//更多情况，请百度搜索：gp服务 查看含地图服务的结果
gp.submitJob(params).then(drawResultData,outError)

关键在于params设置参数，可以看到，4.13中直接设置为Json格式字符串就好了，而不必设置成下面的形式。

//4.13版本中这种不工作
var params = {
    b4:  new RasterData({
            url: "http://localhost:8082/b4.tif", 
            format: "tif" 
        }),
    b3: new RasterData({
            url: "http://localhost:8082/b3.tif", 
            format: "tif" 
        }),
};

这种形式不工作。

2.4 GP服务返回栅格影像

计算植被指数（NDVI），结果是一个tif格式影像，实际上也是RasterData，它是无法直接显示在web客户端的。因此，需要将tif格式的影像发布为影像服务或者是地图服务。
一种简便的方法是：发布GP服务时，英文版勾选【View results with a map service】，中文版勾选【查看含地图服务的结果】，这样，在ArcGIS Server中可以看到GP服务对应的结果服务。

GP服务与结果服务

web端的调用代码如下：

gp.submitJob(params).then(drawResultData,outError)

//接收异步结果，进行绘制
function drawResultData(JobInfo) {
    console.log("分析完成");
    console.log(JobInfo);
    var jobId=JobInfo.jobId;
    console.log(jobId);
    var options = {
        interval: 1500,
        statusCallback: function(j) {
            console.log("Job Status: ", j.jobStatus);
        }
    };

    gp.waitForJobCompletion(jobId, options).then(function() {
        
        //getResultData的第二个参数为发布服务时，看到的结果参数的名称
        gp.getResultData(jobId,"ndvi_result_tif").then(function(Parametervalue){

            console.log(Parametervalue.dataType);

            //需要发布地理服务（gp服务）时启用使用结果地图服务
            //帮助文件请见：http://desktop.arcgis.com/zh-cn/arcmap/latest/analyze/sharing-workflows/using-result-map-service-in-web-applications.htm
            var mapUrl = "http://localhost:6080/arcgis/rest/services/GPNDVI/MapServer/jobs/" + jobId;
            var resultImglayer = new MapImageLayer({
              url: mapUrl
            });
            
            if(resultImglayer){
                map.add(resultImglayer);
            }
            //下面的代码不工作，注释掉
            //resultImglayer.when(function(){
            //  map.add(resultImglayer);
            //});
        }, outError);
    },outError);
}

//输出错误
function outError(e){
    console.log("发生错误");
    console.error(e);
}

其中：var mapUrl = "http://localhost:6080/arcgis/rest/services/GPNDVI/MapServer/jobs/" + jobId; 即为结果服务的调用地址，也就是NDVI计算结果的调用地址。