Download Raster

inputImageLayer

(Required)

The input image, designated as a Portal Item ID, Image Service URL, cloud raster dataset, or shared raster dataset.

At least one type of input must be provided in the JSON object. If multiple input types are available in the same JSON dictionary, the itemId has priority.

The service tool supports downloading from multiple imagery layers in one request.

Syntax: JSON object describes the input from raster.

1
2
3
4
{"itemId": <portal item id>}
{“url”: <image service url>}
{“itemIds”: [<portal item id>, <portal item id>]}
{“urls”: [<image service url>, <image service url>]}

clipSetting

(Required)

The JSON geometry object used to clip the input image. The clipping geometry object can contain the shape description, extent, and clip type.

Syntax: A JSON object supports three case sensitive keys: itemId , url , and uri .

Example:

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "ClippingGeometry": {
    "rings": [[[470614.2631, 8872849.41], [470614.2613, 8920205.3724], [532307.3518, 8920205.3725], [532307.3518, 8872849.41], [470614.2631, 8872849.41]]],
    "spatialReference": {"wkid": 32628}
  }
  "extent": {
    "xmin": 470614.263139,
    "ymin": 8872849.409968,
    "xmax": 532307.351827,
    "ymax": 8920205.372412,
    "spatialReference": {"wkid": 32628}
  }
}

context

Contains settings that affect task execution and results. This task has the following settings:

• ResamplingMethod (resamplingMethod )—Choose the resampling method to use when creating the raster dataset for download.

  • NEAREST—Uses the value of the closest cell to assign a value to the output cell when resampling. This is the default.
  • BILINEAR—Determines the new value of a cell based on a weighted distance average of the four nearest input cell centers.
  • CUBIC—Determines the new value of a cell based on fitting a smooth curve through the 16 nearest input cell centers.

Example:

1
2
3
"resamplingMethod": "BILINEAR" or
"resamplingMethod": "NEAREST" or
"resamplingMethod": "CUBIC"

f

The response format. The default response format is html.

Values: html | json

outputRaster

The output raster download link.

Example:

1
{"url": "https://<raster utilities service url>/DownloadRaster/jobs/<jobId>/results/outputRaster"}

The result has properties for parameter name, data type, and value. The content of the value is always the output raster dataset’s itemId and image service URL.

1
2
3
4
5
6
7
8
9
10
{
  "paramName": "outputRaster",
  "dataType": "GPMultiValue:GPRasterDataLayer",
  "value": [
    {
      "url": "https://<server url>/server/rest/directories/arcgisjobs/utilities/rasterutilities_gpserver/j21fcd7f883fa448c815a076e3b1825fb/scratch/ortho1.tif",
      "format": "tif"
    }
  ]
}