- URL:https://<rastercatalogitem-url>/info
- Required Capability:Catalog
- Version Introduced:10.0
Description
License:
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.
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.
Request parameters
| Parameter | Details |
|---|---|
| f | The response format. The default response format is html. Values: html | json |
Example usage
The following is a sample request URL that demonstrates returning raster info for raster ID 8:
https://machine.domain.com/webadaptor/rest/services/Portland/CascadeLandsat/ImageServer/8/info?f=jsonJSON 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
...
]
}
]
}