Display an imagery layer

Image service showing global land cover raster data at 10 m resolution.

To display rasters from an imagery layer, you need to use a client-side mapping API such as or open source libraries. In most cases, the APIs support a class you can use to make requests to the image service with a service URL. The API is responsible for requesting tiles for the visible map extent.

How to display imagery layer

The steps to display imagery layer are:

  1. Get the URL for the imagery layer service you want to display.
  2. Set the service URL for the imagery layer service.
  3. Add the layer to a map.
1
https://{host}/{organizationId}/arcgis/rest/services/{serviceName}>/ImageServer

Example: https://tiledimageservices.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/European_Space_Agency_WorldCover_2020_Land_Cover_220202a/ImageServer

Code examples

Display an imagery layer

To display a hosted imagery layer, you reference the hosted imagery layer by ID or URL and then add the layer to a map or scene. The client application requests the tiles from the map tile service for the current zoom level.

Steps

  1. Create a map or scene.
  2. Get the hosted imagery layer URL.
  3. Add the layer.
Image service showing global land cover raster data at 10 m resolution.
ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for KotlinArcGIS Maps SDK for SwiftArcGIS Maps SDK for JavaArcGIS Maps SDK for QtEsri LeafletMapLibre GL JSOpenLayersCesiumJS
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
        const imageryLayer = new ImageryLayer({
          portalItem: {
            id: "63fe6ad86c3d4536a3c44a0fbad0045e",
          },
        })
        map.add(imageryLayer)
Expand

Tutorials

Add a vector tile layer

Access and display a vector tile layer in a map.


Add a map tile layer

Access and display a map tile layer in a map.


Query a feature layer (spatial)

Execute a spatial query to get 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.


Workflows

Services

API support

Use or to create, manage, and access . The table below outlines the level of support for each API.

CreateManageAccess
ArcGIS Maps SDK for JavaScript1
ArcGIS Maps SDK for Kotlin1
ArcGIS Maps SDK for Swift1
ArcGIS Maps SDK for Flutter1
ArcGIS Maps SDK for Java1
ArcGIS Maps SDK for .NET1
ArcGIS Maps SDK for Qt1
ArcGIS API for Python
ArcGIS REST JS
Esri Leaflet2
MapLibre GL JS23
OpenLayers23
Full supportPartial supportNo support
  • 1. Use portal class and direct REST API requests
  • 2. Access via ArcGIS REST JS
  • 3. Requires manually setting styles for renderers

Tools

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close