- URL:
- https://<imageservice-url>/rasterAttributeTable
- Methods:
GET- Required Capability:
- Image
- Version Introduced:
- 10.1
Description
The raster resource returns categorical mapping of pixel values (for example, a class, group, category, or membership). This resource is supported if the has property of the service is true.
For a 1-band image service that has a raster attribute table—if red, green, and blue colors are provided in the attribute table—these colors will be used in the export operation by default. To turn off this color mapping, provide "raster for rendering in the export request.
At 10.3 and later, this resource also takes an optional rendering parameter. If the service does not have a raster attribute table but a raster function template does, you can retrieve it through this parameter.
Request parameters
| Parameter | Details |
|---|---|
|
The response format. The default response format is Values: |
| This parameter was added at 10.3 Description: Specifies the rendering rule for how the requested image will be processed. The response is updated service information that reflects a custom processing as defined by the rendering rule. For example, if See the raster function JSON objects for the syntax and examples. |
Example usage
Return attribute table for a land cover image service.
JSON Response syntax
{
"objectIdFieldName" : "<objectIdFieldName>",
"fields" : [
{"name" : "<fieldName1>", "type" : "<fieldType1>", "alias" : "<fieldAlias1>", "length" : "<length1>"},
{"name" : "<fieldName2>", "type" : "<fieldType2>", "alias" : "<fieldAlias2>", "length" : "<length2>"}
],
"features" : [
<feature1>, <feature2>
]
}JSON Response example
{
"objectIdFieldName": "OBJECTID",
"fields": [
{
"name": "OID",
"type": "esriFieldTypeOID",
"alias": "OID",
"domain": null
},
{
"name": "Value",
"type": "esriFieldTypeInteger",
"alias": "Value",
"domain": null
},
{
"name": "Count",
"type": "esriFieldTypeDouble",
"alias": "Count",
"domain": null
},
{
"name": "Red",
"type": "esriFieldTypeSmallInteger",
"alias": "Red",
"domain": null
},
{
"name": "Green",
"type": "esriFieldTypeSmallInteger",
"alias": "Green",
"domain": null
},
{
"name": "Blue",
"type": "esriFieldTypeSmallInteger",
"alias": "Blue",
"domain": null
},
{
"name": "ClassName",
"type": "esriFieldTypeString",
"alias": "ClassName",
"domain": null,
"length": 50
}
],
"features": [
{
"attributes": {
"OID": 0,
"Value": 11,
"Count": 466650898,
"Red": 71,
"Green": 107,
"Blue": 161,
"ClassName": "Open Water"
}
},
{
"attributes": {
"OID": 1,
"Value": 12,
"Count": 1731114,
"Red": 209,
"Green": 222,
"Blue": 250,
"ClassName": "Perennial Snow/Ice"
}
},
{
"attributes": {
"OID": 2,
"Value": 21,
"Count": 287572411,
"Red": 222,
"Green": 202,
"Blue": 202,
"ClassName": "Developed, Open Space"
}
},
{
"attributes": {
"OID": 3,
"Value": 22,
"Count": 124755469,
"Red": 217,
"Green": 148,
"Blue": 130,
"ClassName": "Developed, Low Intensity"
}
},
{
"attributes": {
"OID": 4,
"Value": 23,
"Count": 48230587,
"Red": 238,
"Green": 0,
"Blue": 0,
"ClassName": "Developed, Medium Intensity"
}
},
{
"attributes": {
"OID": 5,
"Value": 24,
"Count": 16773628,
"Red": 171,
"Green": 0,
"Blue": 0,
"ClassName": "Developed, High Intensity"
}
},
{
"attributes": {
"OID": 6,
"Value": 31,
"Count": 106587346,
"Red": 179,
"Green": 174,
"Blue": 163,
"ClassName": "Barren Land"
}
},
{
"attributes": {
"OID": 7,
"Value": 41,
"Count": 992056320,
"Red": 104,
"Green": 171,
"Blue": 99,
"ClassName": "Deciduous Forest"
}
},
{
"attributes": {
"OID": 8,
"Value": 42,
"Count": 1087386133,
"Red": 28,
"Green": 99,
"Blue": 48,
"ClassName": "Evergreen Forest"
}
},
{
"attributes": {
"OID": 9,
"Value": 43,
"Count": 189936312,
"Red": 181,
"Green": 202,
"Blue": 143,
"ClassName": "Mixed Forest"
}
},
{
"attributes": {
"OID": 10,
"Value": 52,
"Count": 1906471766,
"Red": 204,
"Green": 186,
"Blue": 125,
"ClassName": "Shrub/Scrub"
}
},
{
"attributes": {
"OID": 11,
"Value": 71,
"Count": 1285120838,
"Red": 227,
"Green": 227,
"Blue": 194,
"ClassName": "Herbaceous"
}
},
{
"attributes": {
"OID": 12,
"Value": 81,
"Count": 610323595,
"Red": 220,
"Green": 217,
"Blue": 61,
"ClassName": "Hay/Pasture"
}
},
{
"attributes": {
"OID": 13,
"Value": 82,
"Count": 1394827778,
"Red": 171,
"Green": 112,
"Blue": 40,
"ClassName": "Cultivated Crops"
}
},
{
"attributes": {
"OID": 14,
"Value": 90,
"Count": 348297894,
"Red": 186,
"Green": 217,
"Blue": 235,
"ClassName": "Woody Wetlands"
}
},
{
"attributes": {
"OID": 15,
"Value": 95,
"Count": 111141959,
"Red": 112,
"Green": 163,
"Blue": 186,
"ClassName": "Emergent Herbaceous Wetlands"
}
}
]
}