Image Service Layer (ArcGISImageServiceLayer)

An image service provides access to raster data through a web service. Multiple rasters can be served as one image service through mosaic dataset technology, dynamically processed and mosaicked on the fly. An image service supports accessing both the mosaicked image and its catalog, as well as individual rasters in the catalog. Also, image services can be cached (tiled) or uncached (dynamic). This object specifically details properties within uncached image services.

Referenced by: baseMapLayer, operationalLayers

Properties

Property Details
bandIds[] An array of bandIds that are visible, can specify bands to export or rearrange band order(from image service).
blendMode Blend modes are used to create various effects by blending colors of top and background layers. normal blend mode is the default.
Valid values: average, color, color-burn, color-dodge, darken, destination-atop, destination-in, destination-out, destination-over, difference, exclusion, hard-light, hue, invert, lighten, lighter, luminosity, minus, multiply, normal, overlay, plus, reflect, saturation, screen, soft-light, source-atop, source-in, source-out, vivid-light, xor
compressionQuality Controls how much loss the image will be subjected to by the compression algorithm (from image service).
customParameters A sequence of custom parameters appended to the URL of all requests related to a layer.
definitionEditor Stores interactive filters.
disablePopup Boolean property indicating whether to ignore popups defined by the service item.
effect Effect provides various filter functions to achieve different visual effects similar to how image filters (photo apps) work.
format String value representing image format.
Valid values: bmp, gif, jpg, jpgpng, png, png24, png32, png8, tiff
id A unique identifying string for the layer.
interpolation The algorithm used for interpolation.
Valid values:
  • RSP_BilinearInterpolation
  • RSP_CubicConvolution
  • RSP_Majority
  • RSP_NearestNeighbor
isReference This is applicable if used as a baseMapLayer. A boolean value indicating whether or not the baseMapLayer draws on top (true) of other layers, including operationalLayers , or below (false).
itemId Optional string containing the item ID of the service if it's registered on ArcGIS Online or your organization's portal.
layerDefinition An object that defines the attribute schema and drawing information for a layer drawn using client-side graphics.
See layerDefinition properties table.
layerType String indicating the layer type.
Valid value of this property ArcGISImageServiceLayer
maxScale A number representing the maximum scale at which the layer will be visible. The number is the scale's denominator.
minScale A number representing the minimum scale at which the layer will be visible. The number is the scale's denominator.
mosaicRule Specifies the mosaic rule when defining how individual images should be mosaicked.
multidimensionalSubset An object representing a subset from multidimensional data. The data is based on slices or ranges in one or more dimensions in mosaicRule.description. When the multidimensionalSubset is defined then the mosaicRule.multidimensionalDefinition must be within the defined multidimensionalSubset, otherwise nothing will be displayed.
noData The pixel value that represents no information.
noDataInterpretation A string value of interpretation of noData setting. Default is 'esriNoDataMatchAny' when noData is a number, and 'esriNoDataMatchAll' when noData is an array.
Valid values:
  • esriNoDataMatchAll
  • esriNoDataMatchAny
opacity The degree of transparency applied to the layer on the client side, where 0 is full transparency and 1 is no transparency.
pixelType Pertains to the type of values stored in the raster, such as signed integer, unsigned integer, or floating point.
Valid values: C128, C64, F32, F64, S16, S32, S8, U1, U16, U2, U32, U4, U8, UNKNOWN
popupInfo A popupInfo object defining the content of popup windows when you click or query a feature.
refreshInterval Refresh interval of the layer in minutes. Non-zero value indicates automatic layer refresh at the specified interval. Value of 0 indicates auto refresh is not enabled.
renderingRule Specifies the rendering rule for how the requested image should be rendered.
showLegend Boolean value indicating whether to display the layer in the legend. Default value is true.
timeAnimation This property is applicable to layers that support time. If 'true', timeAnimation is enabled.
title A user-friendly string title for the layer that can be used in a table of contents.
url The URL to the layer.
visibility Boolean property determining whether the layer is initially visible in the web map.
visibilityTimeExtent Represents time extent that will control when a layer should be visible based on webmap's current time. Visibility time extent only affects the layer visibility and will not filter the data.

layerDefinition properties

Property Details
definitionExpression SQL-based definition expression string that narrows the data to be displayed in the layer.
drawingInfo.renderer An object defined which provides the symbology for the layer. If working with Map Image layers, this property is only applicable if the layer is enabled with dynamic layers

Additional information

Live sample web map showing ArcGISImageServiceLayer as an operationalLayer.
Live sample web map showing ArcGISImageServiceLayer as a baseMapLayer.

Example

{
  "id": "CharlotteLAS_88",
  "layerType": "ArcGISImageServiceLayer",
  "url": "https://sampleserver6.arcgisonline.com/arcgis/rest/services/CharlotteLAS/ImageServer",
  "visibility": true,
  "blendMode": "color-burn",
  "format": "jpgpng",
  "compressionQuality": 95,
  "opacity": 1,
  "title": "CharlotteLAS",
  "renderingRule": {
    "rasterFunction": "Stretch",
    "rasterFunctionArguments": {
      "StretchType": 5,
      "DRA": false,
      "Gamma": [
        1
      ],
      "UseGamma": true
    },
    "outputPixelType": "U8"
  },
  "mosaicRule": {
    "mosaicMethod": "esriMosaicSeamline",
    "mosaicOperation": "MT_BLEND"
  }
}

Example

{
  "layerType": "ArcGISImageServiceLayer",
  "url": "https://your-multidimensional-service",
  "visibility": true,
  "title": "HYCOM",
  "mosaicRule": {
    "mosaicMethod": "esriMosaicNone",
    "mosaicOperation": "MT_FIRST",
    "multidimensionalDefinition": [
      {
        "variableName": "salinity",
        "dimensionName": "StdTime",
        "values": [
          1356998400000
        ],
        "isSlice": true
      },
      {
        "variableName": "salinity",
        "dimensionName": "StdZ",
        "values": [
          -500
        ],
        "isSlice": true
      }
    ]
  },
  "multidimensionalSubset": {
    "areaOfInterest": {
      "xmin": -171,
      "xmax": -126,
      "ymin": 17,
      "ymax": 56,
      "spatialReference": {
        "wkid": 4326
      }
    },
    "subsetDefinitions": [
      {
        "variableName": "salinity",
        "dimensionName": "StdTime",
        "values": [
          1356998400000,
          1388448000000
        ],
        "isSlice": false
      },
      {
        "variableName": "salinity",
        "dimensionName": "StdZ",
        "values": [
          -1000,
          0
        ],
        "isSlice": false
      },
      {
        "variableName": "water_temp",
        "dimensionName": "StdTime",
        "values": [
          1356998400000,
          1388448000000
        ],
        "isSlice": false
      },
      {
        "variableName": "water_temp",
        "dimensionName": "StdZ",
        "values": [
          -1000,
          0
        ],
        "isSlice": false
      }
    ]
  }
}

Example

{
  "layerType": "ArcGISImageServiceLayer",
  "url": "https://your-multidimensional-service",
  "visibility": true,
  "title": "HeatIndex",
  "renderingRule": {
    "rasterFunction": "MyHeadIndex"
  },
  "mosaicRule": {
    "mosaicMethod": "esriMosaicNone",
    "mosaicOperation": "MT_FIRST",
    "multidimensionalDefinition": [
      {
        "variableName": "temperature",
        "dimensionName": "StdTime",
        "values": [
          1356998400000
        ],
        "isSlice": true
      },
      {
        "variableName": "humidity",
        "dimensionName": "StdTime",
        "values": [
          1356998400000
        ],
        "isSlice": true
      }
    ]
  },
  "multidimensionalSubset": {
    "subsetDefinitions": [
      {
        "variableName": "temperature",
        "dimensionName": "StdTime",
        "values": [
          1356998400000,
          1359720000000
        ],
        "isSlice": false
      },
      {
        "variableName": "humidity",
        "dimensionName": "StdTime",
        "values": [
          1356998400000,
          1359720000000
        ],
        "isSlice": false
      }
    ]
  }
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.