Legend (Image Service)

URL:: https://<imageservice-url>/legend
Methods:: GET
Required Capability:: Image
Version Introduced:: 10.2

Description

The legend resource represents an image service's legend. The legend information includes the symbol images and labels for each symbol. Each symbol is generally an image of 20x20 pixels at 96 dpi. Symbol sizes may vary slightly for some renderer types (for example, Vector Field Renderer). Additional information in the legend response will include the service name, service type, label, and content type.

The legend symbols include the base64 encoded imageData. The symbols returned in response to an image service legend request reflect the default or customized renderer of the image service, selected band IDs, and variable names.

Request parameters

Parameter	Details
`bandIds`	Description: If there are multiple bands, you can specify a single band, or you can change the band combination (red, green, blue) by specifying the band ID. Band ID is 0 based. This is an optional parameter. Example Use dark colors for code blocksCopy `1 bandIds=2,1,0`
`renderingRule`	Specifies the rendering rule for how the requested image should be rendered. This is an optional parameter. See Raster function JSON objects for the syntax and examples.
`variable`	For an image service that has multidimensional information, this parameter can be used to request a legend for each variable. If not specified, it will return a legend for the default variable of the image service. Eligible variable names can be queried from Multidimensional Info image service resource.
`f`	The response format. The default response format is `html`. Values: `html` \| `json` \| `pjson`

Example usage

Example 1: JSON response for an image service; default legend is returned.

Use dark colors for code blocksCopy
https://myserver:6080/arcgis/rest/services/onebandcolormap/ImageServer/legend?f=pjson

Example 2: JSON response for an image service; a different rendering rule is used.

Use dark colors for code blocksCopy
https://myserver:6080/arcgis/rest/services/Legend_1/ImageServer/legend?f=pjson&renderingRule={"rasterFuncton":"MyHillshadeRFT"}

JSON Response syntax

Use dark colors for code blocksCopy
{
  "layers": [
    {
      "layerId": <layerId1>,
      "layerName": "<layerName1>",
      "layerType" : "<layerType1>",
      "minScale": <minScale1>,
      "maxScale": <maxScale1>,
      "legendType": <legendType>, //e.g. RGB Composite, Stretched, Unique Values, Colormap, Classified, Vector Field Renderer
      "legend": [
        {
          "label": "<label11>",
          "url" : "<imageUrl11>",
          "imageData" : "<base64EncodedImageData11>",
          "contentType" : "<contentType11>",
          "height": <height>,
          "width": <width>,
          "values": [<maximum value1>] //optional. array of variant type. In case of classBreaks renderer "values" will contain classMaxValue, In case of uniqueValue renderer "values" will contain ungrouped unique values.
        },
        {
          "label": "<label12>",
          "url" : "<imageUrl12>",
          "imageData" : "<base64EncodedImageData12>",
          "contentType" : "<contentType12>",
          "height": <height>,
          "width": <width>,
          "values": [<maximum value2>]
        }
      ]
    }
  ]
}

JSON Response example

Use dark colors for code blocksCopy
{
  "layers": [
    {
      "layerId": 0;,
      "layerName": "NLCD",
      "layerType": "Raster Layer",
      "minScale": 0,
      "maxScale": 0,
      "legendType": "Unique Values",
      "legend": [
        {
          "label": "WATER",
          "url": "deb6a75248269275154096a102200343",
          "imageData": "iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAIAAAAC64paAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAHUlEQVQ4jWNkYDjBQC5gIlvnqOZRzaOaRzVTRTMAGxgA8IzR4/kAAAAASUVORK5CYII="
          "contentType": "image/png",
          "height": 20,
          "width": 20,
          "values": ["WATER"]
        },
        {
          "label": "AGRICULTURE",
          "url": "09b59498dceabd1da48e8ad3943cc0e3",
          "imageData": "iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAACXBIWXMAAAAAAAAAAAHqZRakAAAAIklEQVQ4jWNsymL4z0BFwERNw0YNHDVw1MBRA0cNHEoGAgCjYgITjF/2XAAAAABJRU5ErkJggg==",
          "contentType": "image/png",
          "height": 20,
          "width": 20,
          "values": ["AGRICULTURE"]
        },
        {
          "label": "GRASS",
          "url": "1d768a27a62203e9b26c147d0969356e",
          "imageData": "iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAACXBIWXMAAAAAAAAAAAHqZRakAAAAIklEQVQ4jWNk+L/qPwMVARM1DRs1cNTAUQNHDRw1cCgZCABNCwLQa4XoegAAAABJRU5ErkJggg==",
          "contentType": "image/png",
          "height": 20,
          "width": 20,
          "values": ["GRASS"]
        }
      ]
    }
  ]
}