Class ArcGISTiledLayer
A layer that can visualize data from an ArcGIS map service or a local TileCache by using previously generated tiles.
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class ArcGISTiledLayer : ImageTiledLayer, INotifyPropertyChanged, ILoadable, ILayerContent, IApiKeyResourceRemarks
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:
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
Applies to
| Target | Versions |
|---|---|
| .NET Standard 2.0 | 100.3 - 200.7 |
| .NET | 100.13 - 200.7 |
| .NET Windows | 100.13 - 200.7 |
| .NET Android | 200.0 - 200.7 |
| .NET iOS | 200.0 - 200.7 |
| .NET Framework | 100.0 - 200.7 |
| Xamarin.Android | 100.0 - 100.15 |
| Xamarin.iOS | 100.0 - 100.15 |
| UWP | 100.0 - 200.7 |