Raster Info

• URL:https://<rastercatalogitem-url>/info
  
• Required Capability:Catalog
• 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 info resource returns information about the associated raster such as its width, height, number of bands, and pixel type.

At 10.7 and later, the raster info resource supports ICS To Pixel. child resource. It returns geometric transformation coefficients that can be used to perform image coordinate system [sensor: Frame] to pixel (column, row) transformation.

At 10.1 and later, the raster info resource supports the following child resources:

• Metadata Resource—Returns metadata for a raster catalog item.
• Raster Thumbnail—Returns a thumbnail for the associated raster.
• Raster Key Properties—Returns key properties for the associated raster.
• Raster ICS—Returns the image coordinate system for the associated raster.

At 10.2 and later, the info resource includes the raster statistics in the response, if available.

At 10.3 and later, the info resource includes the raster histograms in the response, if available.

Request parameters

Parameter	Details
f	The response format. The default response format is html. Values: html | json

Example usage

Example: Return raster info for raster ID 8:

https://sampleserver3.arcgisonline.com/ArcGIS/rest/services/Portland/CascadeLandsat/ImageServer/8/info?f=json

JSON Response syntax

{
  "origin": <origin>,
  "blockWidth": <blockWidth>,
  "blockHeight": <blockHeight>,
  "pixelSizeX": <pixelSizeX>,
  "pixelSizeY": <pixelSizeY>,
  "extent": <extent>,
  "bandCount": <bandCount>,
  "pixelType": "< C128 | C64 | F32 | F64 | S16 | S32 | S8 | U1 | U16 | U2 | U32 | U4 | U8 | UNKNOWN >",
  "firstPyramidLevel": <firstPyramidLevel>,
  "maxPyramidLevel": <maxPyramidLevel>,
  "statistics" : //new at 10.3, optional - depends on whether statistics is available on the dataset.
     [
      [<min1>, <max1>, <mean1>, <standardDeviation1>], //[double, double, double, double]
      [<min2>, <max2>, <mean2>, <standardDeviation2>],
	  ....
    ],
  "histograms": //new at 10.3, optional - depends on whether histograms are available on the dataset.
     [
    <histogram1>, <histogram2>,<histogram3>,...
    ]
}

JSON Response example

{
  "origin" : {"x" : -118.15, "y" : 33.80},
  "blockWidth": 2726,
  "blockHeight": 1,
  "pixelSizeX": 30.386,
  "pixelSizeY": 30.386,
  "extent" : {"xmin" : -119.56, "ymin" : 33.54, "xmax" : -117.37, "ymax" : 36.71},
  "bandCount": 3,
  "pixelType": "U8",
  "firstPyramidLevel": 1,
  "maxPyramidLevel": 9,
  "statistics":[
  [25.2,228.6,102.5,15.8],
  [22.8,235.9,111.2,16.5],
  [32.5,238.8,115.3,17.9]
  ],
  "histograms": [
    {
      "size" : 256, 
      "min" : -0.5, 
      "max" : 255.5, 
      "counts" : [
        42915, 
        23218, 
        24832, 
        25925 
        36054, 
        57097, 
        61278, 
        65211
        ...
        ]
   },
   {
      "size" : 256, 
      "min" : -0.5, 
      "max" : 255.5, 
      "counts" : [
        42915, 
        23218, 
        24832, 
        25925 
        36054, 
        57097, 
        61278, 
        65211
        ...
        ]
   },
   {
      "size" : 256, 
      "min" : -0.5, 
      "max" : 255.5, 
      "counts" : [
        42915, 
        23218, 
        24832, 
        25925 
        36054, 
        57097, 
        61278, 
        65211
        ...
        ]
   } 
 ] 
}