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 ArcGIS Maps SDKs 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.
Use dark colors for code blocksCopy
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 JavaScriptEsri LeafletMapLibre GL JSOpenLayersCesiumJSArcGIS Maps SDK for .NETArcGIS Maps SDK for KotlinArcGIS Maps SDK for SwiftArcGIS Maps SDK for JavaArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Expand
Use dark colors for code blocksCopy
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 feature layer

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.


Query a feature layer (SQL)

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 data management tools or Client APIs to create, manage, and access data services. 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 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.