Raster File

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

Description

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:

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "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

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.