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

Referenced by: baseMapLayer, operationalLayers

Properties

PropertyDetails
blendModeBlend 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
customParametersA sequence of custom parameters appended to the URL of all requests related to a layer.
idA unique identifying string for the layer.
isReferenceThis 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).
itemIdOptional string containing the item ID of the service if it’s registered on ArcGIS Online or your organization’s portal.
layers[]An array of layer objects defining a URL for queries and the popup window content.
See layers properties table.
layerTypeString indicating the layer type.
Valid value of this property ArcGISTiledMapServiceLayer
listModeTo show or hide the sublayer in the layer list. If the layer has sublayers, selecting hide-children will hide them in the layer list.
Valid values:
  • hide
  • hide-children
  • show
maxScaleA number representing the maximum scale at which the layer will be visible. The number is the scale’s denominator.
minScaleA number representing the minimum scale at which the layer will be visible. The number is the scale’s denominator.
opacityThe degree of transparency applied to the layer on the client side, where 0 is full transparency and 1 is no transparency.
pathFor offline data, a path to a tile package file. A URI format is used, starting with file: followed by a file system path with an extension of .tpk or .tpkx. A relative path must be from the file which defines the layer. For example file:../p20/northamerica.tpk.
refreshIntervalRefresh 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.
showLegendBoolean value indicating whether to display the layer in the legend. Default value is true.
titleA 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.
urlURL to the ArcGIS Server tiled Map Service
visibilityBoolean property determining whether the layer is initially visible in the map.
visibilityTimeExtentRepresents time extent that will control when a layer should be visible based on webscene’s current time. Visibility time extent only affects the layer visibility and will not filter the data.

layers properties

PropertyDetails
disablePopupIndicates whether to allow a client to ignore the popups defined on the layer. The popupInfo object could be saved in the map or item.
idThe layer id, as a numeric value.
layerItemIdThe associated query layer’s itemId. Only available when there is a layerUrl. You will see this if popups are configured on it.
layerUrlA URL to a service that should be used for all queries against the layer.
listModeTo show or hide the sublayer in the layer list. If the layer has sublayers, selecting hide-children will hide them in the layer list.
Valid values:
  • hide
  • hide-children
  • show
nameThe name of the layer.
popupInfoA popupInfo object defining the popup window content for the layer.
showLegendA Boolean indicating if the layer should be shown in the legend in client applications.

operationalLayer Example

Live sample web scene showing the ArcGISTiledMapServiceLayer as an operationalLayer

{
"id": "World_Imagery_6919",
"layerType": "ArcGISTiledMapServiceLayer",
"url": "https://services.arcgisonline.com/arcgis/rest/services/World_Imagery/MapServer",
"visibility": true,
"opacity": 0.34,
"title": "World_Imagery",
"minScale": 147914382,
"maxScale": 70.5310735,
"blendMode": "normal"
}

baseMapLayer Example

Live sample web scene showing the ArcGISTiledMapServiceLayer as a baseMapLayer

{
"id": "World_Terrain_Base_3",
"layerType": "ArcGISTiledMapServiceLayer",
"url": "https://services.arcgisonline.com/ArcGIS/rest/services/World_Terrain_Base/MapServer",
"visibility": true,
"opacity": 1,
"title": "World Terrain Base",
"blendMode": "normal"
}