Show / Hide Table of Contents

Class ArcGISTiledLayer

A layer that can visualize data from an ArcGIS map service or a local TileCache by using previously generated tiles.

Inheritance
System.Object
Layer
ImageAdjustmentLayer
ImageTiledLayer
ArcGISTiledLayer
Implements
System.ComponentModel.INotifyPropertyChanged
ILoadable
ILayerContent
IApiKeyResource
ImageTiledLayer.TileInfo
ImageTiledLayer.FullExtent
ImageTiledLayer.GetTileDataAsync(Int32, Int32, Int32, CancellationToken)
ImageTiledLayer.NoDataTileBehavior
ImageAdjustmentLayer.Brightness
ImageAdjustmentLayer.Contrast
ImageAdjustmentLayer.Gamma
Layer.LoadAsync()
Layer.CancelLoad()
Layer.RetryLoadAsync()
Layer.LoadStatus
Layer.LoadError
Layer.Item
Layer.Attribution
Layer.Description
Layer.MaxScale
Layer.MinScale
Layer.SpatialReference
Layer.Opacity
Layer.Id
Layer.Clone()
Layer.CanChangeVisibility
Layer.IsVisible
Layer.IsIdentifyEnabled
Layer.Name
Layer.ShowInLegend
Layer.SublayerContents
Layer.GetLegendInfosAsync()
Layer.IsVisibleAtScale(Double)
Layer.PropertyChanged
Layer.OnPropertyChanged(String)
Layer.Loaded
Layer.LoadStatusChanged
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.ToString()
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class ArcGISTiledLayer : ImageTiledLayer, INotifyPropertyChanged, ILoadable, ILayerContent, IApiKeyResource
Remarks

ArcGIS tiled layers consume image tiles provided by an ArcGIS map service or a local tile package. Raster tiles are cached at various scales when the map service is created. This API requests the tiles needed at a particular map extent. ArcGISTiledLayer will display data from an ArcGIS MapServer if "Single Fused Map Cache" is set to true in its ArcGIS REST Services Directory.

You can use the ExportTileCacheTask class to generate and download tiles from the service, creating a tile package (.tpk/.tpkx) for use locally on the device. Alternatively, you can use ArcGIS Pro to create a map tile package and provision it to the device.

Functional characteristics

ArcGIS tiled layers do not support re-projection, query, select, identify, or editing.

Performance characteristics

Image tiled based layers (those that derive functionality from the ImageTiledLayer class) provide fast display of geographic information stored in raster files. These rasters typically contain image data acquired from satellite, aircraft, or drones. The resolution of such imagery can be very high, providing a detailed view. With increased resolution comes increased file sizes and potentially slower performance.

Raster tiling is a process that re-samples the pixel size at different scales to create images with the appropriate resolution for each scale. The tiling process creates level-of-detail pyramids to efficiently manage how much detail you see as you zoom in and out on the map. Typically, as you zoom closer to the Earth's surface, you want to see greater detail of the geographic information. Tiled image layers allow you to see just the information you need very quickly based on the level-of-detail pyramid at a particular scale, rather than having to load a single large image at once.

Tiles are generated by the server when the service is created. Requests for tiles are made on multiple threads and handled asynchronously. The size of each returned tile increases as the resolution or complexity of the image in the tile increases. For example, high-resolution imagery tiles can result in larger in file sizes than topographic mapping for the same area and map extent.

Sample Code:

  • ArcGIS tiled layer
  • Export tiles

Constructors

Name Description
ArcGISTiledLayer(TileCache)

Initializes a new instance of the ArcGISTiledLayer class from a local TileCache.

ArcGISTiledLayer(Item)

Initializes a new instance of the ArcGISTiledLayer class from the specified Item.

ArcGISTiledLayer(Uri)

Initializes a new instance of the ArcGISTiledLayer class from the specified URI.

Properties

Name Description
ApiKey

Gets or sets the API key that allows your app to access ArcGIS location services and private portal items.

RefreshInterval

Gets or sets the refresh interval on an ArcGISTiledLayer.

ServiceInfo

Gets the map service information.

Source

Gets or sets the endpoint of the map service or the path to a local tile package.

Sublayers

Gets a read-only collection of ArcGISSublayer objects in the ArcGISTiledLayer.

TileCache

Gets the TileCache representing information about a local tile package.

See Also

Layer
ImageTiledLayer

Applies to

TargetVersions
.NET Standard 2.0100.3 - 200.7
.NET100.13 - 200.7
.NET Windows100.13 - 200.7
.NET Android200.0 - 200.7
.NET iOS200.0 - 200.7
.NET Framework100.0 - 200.7
Xamarin.Android100.0 - 100.15
Xamarin.iOS100.0 - 100.15
UWP100.0 - 200.7

Relevant samples

Display layer view state: Determine if a layer is currently being viewed.
Edit and sync features: Synchronize offline edits with a feature service.
Export tiles: Download tiles to a local tile cache file stored on the device.
Generate geodatabase: Generate a local geodatabase from an online feature service.
In This Article
Back to top Copyright © 2022 Esri.