Skip To Content
ArcGIS Developer
Dashboard

Raster File

  • URL:https://<imageservice-url>/file
  • Required Capability:Catalog, Download
  • Version Introduced:10.0

Description

License:

As of 10.5, you must license your ArcGIS Server as an ArcGIS Image Server to use this resource.

The Raster File resource represents a single raw raster file. The id required to request the file can be obtained using the Download Rasters operation.

This resource streams the file contents to the client.

Request parameters

ParameterDetails
id

(Required)

Description: The ID of the raster file. This ID is obtained using the Download Rasters operation.

Example: Suppose the Download Rasters operation returned the following response:

{
  "rasterFiles": [
   {
    "id": "t1923.png",
    "rasterIds": [54],
    "size": 65417
   },
   {
    "id": "t1923.pgw",
    "rasterIds": [54],
    "size": 765368
   },
   {
    "id": "t1923.png.aux.xml",
    "rasterIds": [54],
    "size": 853
   },
   {
    "id": "t1928",
    "rasterIds": [60],
    "size": 786296
   }
  ]
}

You can download the second file in this response by specifying its id as the query parameter for this resource: id=t1923.pgw.

rasterId

(Required)

Description: The object ID of the raster item. This ID is obtained using the Download Rasters operation. This is required if the source raster is a GRID, WCS, or geodatabase raster.

Example: You can download the fourth raster from the example response by specifying its id and rasterId as the query parameters for this resource: id=t1928&rasterId=60.

Example usage

Example 1: Access the raster file resource for ID: https://myserver.mydomain.com/1n2w13w.jpg.

https://myserver.mydomain.com/ArcGIS/rest/services/ImageServiceName/ImageServer/file?id=https://servername/1n2w13w.jpg&rasterId=61

Example 2: Access a geodatabase raster resource.

https://myserver.mydomain.com/ArcGIS/rest/services/ImageServiceName/ImageServer/file?id=t1928&rasterId=60