Scenes (3D)

and provide interactive displays of geographic data that enable you to visualize and explore patterns, answer questions, and share insight. They can be opened, edited, and shared across the ArcGIS system and beyond. While the programming patterns are similar and many of the classes you work with are the same, maps are designed for working with geographic data in two dimensions (2D) and scenes in three dimensions (3D). Most applications contain a to display geographic data with streets or satellite imagery, but you can also use and to display additional data. See Maps (2D) in this guide for more information about working with maps.

You can use a and a to:

  • Display a such as streets or satellite imagery.
  • Access and display based on files or services, including data you have authored.
  • Display terrain with an .
  • Display real-world objects such as buildings, cars, and trees.
  • Display 3D visualizations of 2D objects.
  • Perform 3D analysis, such as line-of-sight, visibility, and 3D measurements.
  • Provide context for temporary points, lines, polygons, or text displayed as .
  • Measure distance and explore spatial relationships between .
  • Inspect data layers and display information from .

How a scene works

A works together with a to display geographic content in three dimensions. A scene contains a collection of including multiple from online or local sources, a that gives geographic context, and a base surface containing . A scene can also contain datasets that enable searches for addresses or place names, networks for solving , and non-spatial tables.

For workflows (when you don't have network connectivity), you can open a scene stored in a . You can create mobile scene packages using ArcGIS Pro, share them using your ArcGIS organization, or distribute directly by copying to a device. See Offline maps, scenes, and data for more information about implementing offline workflows in your app.

Scene

A scene contains a collection of . Two dimensional layers are displayed in the order in which they are added, while three dimensional layers are displayed using the layer's elevation information. You can use the scene to change the display order of two dimensional layers as well as to control which layers are visible, and expose this functionality with user interface controls such as lists, check boxes, or switches. Scenes extend the concept of a basemap by introducing a base surface that contains a collection of . Layers can be draped on top of the surface, positioned relative to the surface or displayed based on their absolute values.

You can instantiate a new ArcGISScene object by creating a new scene and building it entirely with code. With this approach, you typically first add a and then one or more .

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
    // API key authentication or user authentication is required to access basemaps and other location services.
    ArcGISEnvironment.apiKey = ApiKey.create(YOUR_ACCESS_TOKEN)

    // Create a map with an ArcGIS basemap style.
    val scene = ArcGISScene(BasemapStyle.ArcGISTopographic)

    val worldElevationServiceURL = "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"
    val elevationSource = ArcGISTiledElevationSource(worldElevationServiceURL)
    val surface = Surface().apply {
        elevationSources.add(elevationSource)
    }
    val point = Point(
        x = -118.808, y = 33.961, z = 2000.0,
        spatialReference = SpatialReference.wgs84()
    )
    val camera = Camera(
        locationPoint = point,
        heading = 0.0,
        pitch = 75.0,
        roll = 0.0
    )
    scene.apply {
        baseSurface = surface
        initialViewpoint = Viewpoint(point, camera)
    }

You can also instantiate an ArcGISScene that's stored in a (such as ArcGIS Online) using its item ID or URL.

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
    val portal = Portal("https://www.arcgis.com", Portal.Connection.Anonymous)
    val portalItem = PortalItem(portal, "31874da8a16d45bfbc1273422f772270")
    val scene = ArcGISScene(portalItem)

    // Or you can use the URL of the portal item:
    // val scene = ArcGISScene("https://www.arcgis.com/home/item.html?id=31874da8a16d45bfbc1273422f772270")

When the ArcGISScene first appears in the SceneView, you can focus the initial display at a specified view point with the ArcGISScene.initialViewpoint method. If an initial view point is not defined, the scene will initially display at a global scale.

Layer

Each in a scene references geographic data, either from an online service or from a local dataset. There are a variety of layers that can be added to a scene, each designed to display a particular type of data. Some layers display images, such as satellite photos or aerial photography, others are composed of a collection of to represent real-world entities using point, line, or polygon . In addition to geometry, features have that provide details about the entity it represents.

Scenes can also contain enabling you to create advanced 3D visualizations. Scene layers can contain one of four data types: points, point cloud, 3D objects, or an integrated mesh. To learn more about scene layers, visit What is a scene layer? in the ArcGIS Pro documentation.

The Layer class is the base class for all types of layers. The type of layer you create depends on the type of data you want to display. For example, to display feature data you can create a FeatureLayer that references an online service (such as a ) or a supported local dataset. Some layers cannot be displayed in a scene, such as ArcGISVectorTiledLayer and AnnotationLayer. Similarly, 3D layers cannot be displayed in a , such as ArcGISSceneLayer.

Add layers to a scene
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
        ArcGISEnvironment.apiKey = ApiKey.create(YOUR_ACCESS_TOKEN)

        scene = ArcGISScene(BasemapStyle.ArcGISTopographic)

        val trailheadsLayer = FeatureLayer.createWithFeatureTable(
            ServiceFeatureTable("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0")
        )

        val trailsLayer = FeatureLayer.createWithFeatureTable(
            ServiceFeatureTable("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0")
        )

        val openSpacesLayer = FeatureLayer.createWithFeatureTable(
            ServiceFeatureTable("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0")
        )

        scene.operationalLayers.addAll(listOf(openSpacesLayer, trailsLayer, trailheadsLayer))

Camera

Scenes and scene views extend the concept of two dimensional viewpoints with a that represents the observer's position and perspective within three dimensions.

The following properties define the camera position:

  • Geographic location on the surface (longitude and latitude)
  • Altitude (height, in meters, above sea level)
  • Heading (angle about the z axis the camera is rotated, in degrees)
  • Pitch (angle the camera is rotated up or down, in degrees)
  • Roll (angle the camera is rotated side-to-side, in degrees)
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
                            val cameraLocation = Point(
                                x = 13.409444,
                                y = 52.520833,
                                z = 1000.0,
                                spatialReference = SpatialReference.wgs84()
                            )

                            val sceneCamera = Camera(
                                locationPoint = cameraLocation,
                                heading = 180.0,
                                pitch = 0.0,
                                roll = 0.0
                            )

                            sceneViewProxy.setViewpointCamera(sceneCamera)

                            // Alternative: When creating the ArcGISScene instance, you can set the ArcGISScene.initialViewpoint property.

A has an associated controller that manages the for the . Each type of camera controller is designed to provide a specific user experience for interacting with the scene display. The camera controller and its properties can be changed at run time, enabling you to provide the scene view interaction experience best suited for the current context.

When a camera controller other than the default GlobeCameraController is active, the scene view's viewpoint cannot be assigned. Attempts to do so do not raise an exception, but they are ignored.

The following camera controllers are available:

  • GlobeCameraController (default)—Provides the default scene view camera behavior. Allows the user to freely move and focus the camera anywhere in the scene.
  • OrbitGeoElementCameraController—Locks the scene view's camera to maintain focus relative to a (possibly moving) graphic. The camera can only move relative to the target graphic.
  • OrbitLocationCameraController—Locks the scene view's camera to orbit a fixed location (map point). The camera can only move relative to the target map point.
  • TransformationMatrixCameraController—Provides navigation by using a TransformationMatrix to control the camera's location and rotation. You need to pass this object to all TransformationMatrixCameraController functions. This can be used with transformation matrices produced by Augmented Reality APIs like ARKit (iOS) and ARCore (Android).
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
            val sceneViewProxy = remember { SceneViewProxy() }

                // Create a camera controller to orbit a stationary geoelement in the scene view.
                // Pass geoelement (graphic) and distance (meters). Geoelement here is green diamond at Berlin TV Tower.
                cameraController = OrbitGeoElementCameraController(
                    targetGeoElement = berlinTvTowerGraphic, distance = 500.0
                ).apply {
                    setCameraPitchOffset(75.0)
                }

                        SceneView(
                            // Pass the scene to the Composable SceneView.
                            arcGISScene = scene,
                            cameraController = cameraController,
                            graphicsOverlays = graphicsOverlays,
                            sceneViewProxy = sceneViewProxy,

                        )

SceneView

A is a user interface control that displays a single scene in your application. It contains built-in functionality that allows the user to explore the scene by zooming in and out, panning and rotating, or getting additional information about elements in the scene. Scene views may also contain in one or more .

After creating a , you typically set the and the position. Unlike a map, a scene uses a camera to define the viewer's perspective and to determine the visible area. The perspective is defined by setting the camera's position, location, altitude (height), heading, and tilt.

Add an ArcGISScene to a SceneView control to display it. Changes you make to the scene, such as adding, removing, or reording layers, will immediately be reflected in the display. The ArcGISScene.initialViewpoint method will set the area shown when the scene loads.

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
    scene.initialViewpoint = Viewpoint(point, camera)

    // The Compose equivalent of the view-based SceneView class.
    SceneView(
        modifier = Modifier.fillMaxSize(),
        // Pass the scene to the Composable SceneView.
        arcGISScene = scene
    )

A control also allows you to:

  • Adjust light, atmosphere, and space effects.
  • Display image overlays on the scene surface.
  • Lock the camera to a location or .
  • Add analysis overlays to visualize analysis results.
  • Identify and select features using a mouse or tap location.
  • Export an image of the current display.
  • Apply a time extent to filter the display of features.

Examples

Display a scene with elevation

This example uses an ArcGISScene and SceneView to display the topographic . The basemap layer is draped on an elevation layer to create a 3D perspective. A Camera is created to define the initial view of the scene.

Steps

  1. Create an ArcGISScene and add a .
  2. Use an elevation service with ArcGISScene.baseSurface to define a base surface.
  3. Create a SceneView and set the position.
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
                // Create a map with an ArcGIS basemap style.
                val scene = ArcGISScene(BasemapStyle.ArcGISTopographic)

                val elevationSource =
                    ArcGISTiledElevationSource("https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer")
                val surface = Surface().apply {
                    elevationSources.add(elevationSource)
                }

                val point = Point(
                    x = -118.808, y = 33.961, z = 2000.0,
                    spatialReference = SpatialReference.wgs84()
                )
                val camera = Camera(
                    locationPoint = point,
                    heading = 0.0,
                    pitch = 75.0,
                    roll = 0.0
                )
                scene.apply {
                    baseSurface = surface
                    initialViewpoint = Viewpoint(point, camera)
                }

                SceneView(
                    modifier = Modifier.fillMaxSize(),
                    // Pass the map to the Composable SceneView.
                    arcGISScene = scene
                )
Expand

Display a scene from a mobile scene package

This example displays a from a . You can create your own mobile scene packages using ArcGIS Pro or download existing ones from ArcGIS Online. The Philadelphia scene package, for example, shows an area of downtown Philadelphia with textured buildings.

Steps

  1. Create a MobileScenePackage using the path to a local .mspk file.
  2. Call MobileScenePackage.load() to load the package.
  3. When the package loads, get the first scene from the package using MobileScenePackage.scenes.
  4. Display the scene in a SceneView.
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
77
78
        // Create the mobile map package
        val scenePackage = MobileScenePackage(filePath)
        lifecycleScope.launch {
            // Load the mobile map package.
            scenePackage.load().getOrElse {
                // Mobile map package failed to load.
                showError("Map package failed to load: ${it.message.toString()}")
            }
            // Add the loaded map from the mobile map package to the mutable ArcGISMap used by the Composable MapView.
            scene = scenePackage.scenes.first()
        }
Expand

Tutorials

Samples

Change camera controller

Display scene from mobile scene package

Display scene

Services

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