Class ArcGISTiledLayer
This class allows you to display data from an ArcGIS Server 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 tile package.
Raster tiles are cached by the server at various scales instead of dynamically generating
map images at the request of the client application. The client requests the tiles needed at
a particular map extent. 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. Note: You can tell if an ArcGIS map server is hosting
a compatible ArcGISTiledLayer when the Single Fused Map Cache is set to true in
the ArcGIS REST Services Directory.
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 unique key generated from ArcGIS Developers website. |
| 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 - 100.15 |
| .NET 6.0 | 100.13 - 100.15 |
| .NET 6.0 Windows | 100.13 - 100.15 |
| .NET Framework | 100.0 - 100.15 |
| .NET 5 | 100.10 - 100.12 |
| .NET Core 3.1 | 100.7 - 100.12 |
| Xamarin.Android | 100.0 - 100.15 |
| Xamarin.iOS | 100.0 - 100.15 |
| UWP | 100.0 - 100.15 |