Layers make up the primary content of applications you will build with ArcGIS. Layers can be based on services exposed via the ArcGIS REST API, GeoJSON, CSV, or other files available on disk or over a network. Layers can also be created in your applications from arbitrary data loaded over a network or from disk using the ArcGIS APIs and SDKs. Individual graphics can also be displayed on maps using graphics layers.
Layers are logical collections of geographic data that can be used to create maps and applications, and can be broadly categorized as either feature or tile layers:
Feature layers can store geographic features, edit or update attributes, and synchronize with offline databases.
Tile layers are pre-generated and the tiles are cached on a server. Vector tile basemaps, for example, are tile layers. Scene Layers can be thought of as tile layers that cache features, including 3D objects like buildings, for rapid display in 3D applications.
Core ArcGIS Layer types
This table summarizes some of these core layer types and their common use cases.
|Layer Type||REST API Service||Hosted In||Cached ||Use Cases|
|ArcGIS Online ||ArcGIS Enterprise|
|Feature Layer||Feature Service||Querying, rendering, and editing vector geographic information.|
|Tile Layer||Map Service||Basemaps and other complex datasets that change infrequently. Tiles can be kept in sync with feature layers for operational data.|
|Vector Tile Layer||Vector Tile Service||Basemaps and other complex datasets that change infrequently. Tiles can be kept in sync with feature layers for operational data.|
|Dynamic Map Layer||Map Service||Complex data sets that change frequently or need complex rendering requirements.|
|Image Layer||Image Service||Rendering and analyzing satellite or other imagery data.|
|Scene Layer||Scene Service||Displaying and rendering 3D datasets.|
: Although some layers cannot be hosted with
: Cached layers are preprocessed so they can be quickly read and delivered to clients. Uncached layers make database queries and leverage HTTP caching only.
Other Layer types
In addition to the core layer types,
The supported layer types vary by SDK so check the samples and API reference of the SDK you are using to verify. In addition to supporting a variety of common file types such as CSV, GeoRSS, and KML, all ArcGIS APIs and SDKs support a basic graphics layer for adding arbitrary graphics to the map that can be extended into custom layer types.
Working with Layers
The ArcGIS platform allows for multiple ways to create, edit, and share layers.
With ArcGIS APIs and SDKs
With ArcGIS REST API
All of the core ArcGIS layer types are backed by a service hosted on an instance of an ArcGIS Server. The ArcGIS APIs and SDKs interact with an ArcGIS Server using the ArcGIS REST API.
Developers can also make requests directly to the REST API to add specific and unique GIS functionality to their applications.
In Web Maps
Web maps allow developers to create reusable sets of layers and configuration options that can be shared between multiple apps or users. For more details see the Introduction to Web Maps and the Web Map Specification.
Layers can be added to web map
operationalLayers properties and referenced either by their item id in
You can learn more about adding layers to web maps in the ArcGIS Online "Add layers" topic.
How layers are created varies across the ArcGIS platform.
- ArcGIS tutorials: Import CSV, GeoJSON, Shapefile or File GeoDatabase
- ArcGIS tutorials: Define a schema for a new empty Feature Layer
- ArcGIS Online: Publish feature layers from a variety of formats
- ArcGIS Enterprise: Publish features
- ArcGIS Pro: Create and share feature layers with ArcGIS Pro
Vector Tile Layers
- ArcGIS Pro: Publish vector tiles
Dynamic Map Layers
- ArcMap: Publish a map service
- ArcMap: Create a mosaic dataset