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:

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.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close