Skip To Content ArcGIS for Developers Sign In Dashboard

Web Map Specification

Tiled Map Service Layer (ArcGISTiledMapServiceLayer)

An ArcGIS Tiled Map Service layer displays map content from an ArcGIS Server Map service that has been cached (tiled).

Referenced by: baseMapLayer, operationalLayers


Property Details
blendMode Blend modes are used to create various effects by blending colors of top and background layers. normal blend mode is the default.
If property is present, must be one of the following values: average, color-burn, color-dodge, color, 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
displayLevels NOTE: Applicable if used as a baseMapLayer. Integer value(s) indicating the display levels of the basemap layer. Only applicable for TiledMapService layers. All tiled map service layers should share the same tiling scheme. This property cannot be set via the Map Viewer UI.
exclusionAreas NOTE: Applicable if used as a baseMapLayer. An array of exclusionArea objects defining the layer exclusions.
id A unique identifying string for the layer.
isReference This property 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.
layerType String indicating the layer type.
Value of this property must be ArcGISTiledMapServiceLayer
layers An array of layer objects defining a URL for queries and the popup window content.
See layers properties table.
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.
opacity The degree of transparency applied to the layer on the client side, where 0 is full transparency and 1 is no transparency.
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.
showLegend Boolean value indicating whether to display the map service layer in the legend.
title A user-friendly string title for the layer that can be used in a table of contents. If this is not included, a title is derived from the service.
url URL to the ArcGIS Server tiled Map Service
visibility Boolean property determining whether the layer is initially visible in the map.

layers properties

Property Details
disablePopup Indicates whether to allow a client to ignore the popups defined on the layer. The popupInfo object could be saved in the map or item.
id The layer id, as a numeric value.
layerItemId The associated query layer's itemId. Only available when there is a layerUrl. You will see this if popups are configured on it.
layerUrl A URL to a service that should be used for all queries against the layer.
popupInfo A popupInfo object defining the popup window content for the layer.
showLegend A Boolean indicating if the layer should be shown in the legend in client applications.

operationalLayer Example

Live sample web maps showing the ArcGISTiledMapServiceLayer as an operationalLayer

  "operationalLayers": [
      "id": "World_Imagery_6919",
      "layerType": "ArcGISTiledMapServiceLayer",
      "url": "",
      "visibility": true,
      "opacity": 0.34,
      "title": "World_Imagery",
      "minScale": 147914382,
      "maxScale": 70.5310735

baseMapLayer Example

Live sample web maps showing the ArcGISTiledMapServiceLayer as a baseMapLayer

  "baseMapLayers": [
      "id": "World_Terrain_Base_3",
      "layerType": "ArcGISTiledMapServiceLayer",
      "url": "",
      "visibility": true,
      "opacity": 1,
      "title": "World Terrain Base"
      "id": "World_Reference_Overlay_5790",
      "layerType": "ArcGISTiledMapServiceLayer",
      "url": "",
      "visibility": true,
      "opacity": 1,
      "title": "World Reference",
      "isReference": true
  "title": "Terrain with Labels"

Feedback on this topic?