Hosted image tile layers
What is a hosted image tile layer?
A hosted image tile layer is a reference to an image tile layer in an image tile service used to store your data. Applications can use image tile layers to display large amounts of geographic data in a map or scene with static image files.
You use hosted image tile layers when you want to:
- Convert feature layers to image tile layers.
- Store and access data as pre-cached image tiles in different formats e.g. JPEG or PNG.
- Optimize accessing and displaying large amounts of data as tiles.
- Use image tile data in offline applications.
How an hosted image tile works
You can create hosted image tile layers by converting existing hosted feature layers to tile layers. A hosted image tile layer references a MapService service that serves tiles (or levels) of png or jpeg images of geographic data. To get tile data, you make requests to the MapService.
Manage an image tile layer
An item page allows you to manage the properties and settings for a hosted image tile layer. You can access an item page by signing in to your developer dashboard or ArcGIS Online. Once signed in, you can set properties such as the name, description, tags, and sharing settings.
View an image layer item page
To access an item page directly, use a portal search URL with the ID for the item. The portal URL for data hosted in ArcGIS is https://www.arcgis.com. To use this URL, the item must be shared publicly.
Example: https://www.arcgis.com/home/item.html?id=366d13d521b844119c9052758b33afc9
Access an image tile layer
An image tile service hosts tile data. You can discover information about a layer by accessing the service endpoint directly. The endpoint returns properties such as the service name, item ID, spatial reference, extent, and tile information.
Get image tile layer properties
To access the layer or get
properties, use a URL with the host and service name.
Get image layer tile data
To access layer data, use a URL with the host, service name, and path to tiles in {z}/{y}/{x}
format.
Code examples
Display an image tile layer
To display a hosted image tile layer, you reference the hosted image tile layer by ID or URL and then add the layer to a map or scene. The client application requests the tiles from the image tile service for the current zoom level.
Steps
- Create a map or scene.
- Get the hosted image tile layer URL.
- Add the layer.
Tutorials

Add a feature layer
Access and display point, line, and polygon features from a feature service

Add a vector tile layer
Access and display a vector tile layer in a map.

Add an image tile layer
Access and display an image tile layer in a map.

Style a feature layer
Use symbols and renderers to style feature layers.

Query a feature layer (spatial)
Execute a spatial query to get features from a feature layer.

Query a feature layer (SQL)
Execute a SQL query to access polygon features from a feature layer.

Edit feature data
Add, update, and delete features in a feature service.

Display a popup
Format a popup to show attributes in a feature layer.
Services
Feature service
Add, update, delete, and query feature data.
Vector tile service
Store and access vector tile data.
Image tile service
Store and access image tile data.
API support
- 1. Access portal via HTTP request and authentication.
- 2. Access via ArcGIS REST JS.
- 3. Requires manual application of renderers