Overview

A global sceneA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more provides an interactive display of geographic data that enables you to visualize and explore patterns, answer questions, and share insight in three dimensions (3D). Global scenes can be opened, edited, and shared across the ArcGIS system and beyond. They are typically used to display data that spans a large area where viewing the curvature of the earth is important and is spatially referenced using a geographic coordinate system.

You can use a global sceneA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more and SceneView to:

• Display a basemap layerA basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service.Learn more such as streets or satellite imagery.
• Access and display data layersA data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene.Learn more based on files or services, including data you have authored.
• Display terrain with an elevation layerAn elevation layer is a layer that defines the ground height or the surface for a scene.Learn more.
• 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 graphicsA graphic is a visual element composed of a geometry, symbol, and attributes that is displayed on a map or scene.Learn more.
• Measure distance and explore spatial relationships between geometriesA geometry is a geometric shape, such as a point, polyline, or polygon, that contains one or more coordinates and a spatial reference.Learn more.
• Inspect data layers and display information from attributesAttributes are fields and values for a single feature or non-spatial record. They are typically stored in a database or service such as a feature service.Learn more.

Scene

The introduction explained the concept of a sceneA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more and how it works. The Scene is your entry point into the API when working with three dimensional data. However, when working with global scenes you connect them with SceneView in order to display the data within an application. Remember that when you are working with global scenes, the SceneViewingMode is set to global. When creating a scene programmatically, the viewing mode needs to be set. If consuming a global web scene itemAn item, also known as a content item, is a resource stored in a portal such as a web map, hosted layer, style, script tool, file, or notebook.Learn more from a portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more, this information is gathered from the item's definition for you. For cases when the SceneViewingMode is set to local, consult the local scene overview topic for details as it is different from working with a global scene. Logically, when programmatically building a global scene, the next step is to add data layersA data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene.Learn more to your scene.

Layer

Each layerA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more 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 featuresA feature is a single record, also known as a row, that represents a real-world entity. It typically contains a geometry (point, multipoint, polyline, or polygon) and attributes but it can also contain just attributes.Learn more to represent real-world entities using point, line, or polygon geometriesA geometry is a geometric shape, such as a point, polyline, or polygon, that contains one or more coordinates and a spatial reference.Learn more. In addition to geometry, features have attributesAttributes are fields and values for a single feature or non-spatial record. They are typically stored in a database or service such as a feature service.Learn more that provide details about the entity the feature represents.

Scenes can also contain scene layersA scene layer is a data layer is used to access and display 3D data from a scene service.Learn more that enable you to create advanced 3D visualizations. Scene layers can contain one of four data types: points, point clouds, 3D objects, or integrated meshes.

The Layer class is the base class for all types of layers used in ArcGIS Maps SDK for Swift. 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 feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more) 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 Map, such as ArcGISSceneLayer.

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
        // Set your API key during app initialization.
        // ArcGISEnvironment.apiKey = APIKey("<#YOUR-ACCESS-TOKEN#>")

        let scene = Scene(
            basemapStyle: .arcGISTopographic
        )

        let trailheadsLayer = FeatureLayer(
            featureTable: ServiceFeatureTable(
                url:
                    URL(string: "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0")!
            )
        )
        let trailsLayer = FeatureLayer(
            featureTable: ServiceFeatureTable(
                url:
                    URL(string: "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0")!
            )
        )

        let openSpaceLayer = FeatureLayer(
            featureTable: ServiceFeatureTable(
                url:
                    URL(string: "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0")!
            )
        )

        scene.addOperationalLayers([trailheadsLayer, trailsLayer, openSpaceLayer])

Camera

Global scenes and global scene views extend the concept of two dimensional viewpoints with a cameraA camera defines the rendering viewpoint of a 3D scene in a scene view.Learn more 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
        let point = Point(x: -118.804, y: 34.027, z: 5330.0, spatialReference: .wgs84)
        let camera = Camera(location: point, heading: 355.0, pitch: 72.0, roll: 0)
        scene.initialViewpoint = Viewpoint(boundingGeometry: point, camera: camera)

SceneView has an associated controller that manages the cameraA camera defines the rendering viewpoint of a 3D scene in a scene view.Learn more for the global sceneA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more. 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.

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
    let orbitCameraController: OrbitGeoElementCameraController = {
        let plane3D = Graphic()
        let orbitCameraController = OrbitGeoElementCameraController(target: plane3D, distance: 26)
        orbitCameraController.cameraPitchOffset = 75.0
        return orbitCameraController
    }()

    var body: some View {
        SceneView(scene: scene, cameraController: orbitCameraController)
    }

The following camera controllers are provided:

• 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).

SceneView

A scene viewA scene view is a user interface that displays scene layers and graphics in 3D. It uses a camera to control the visible area of the scene and supports user interactions such as pan, zoom, tilt, and rotate.Learn more is a user interface control that displays a single global 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 global scene. Scene views may also contain graphicsA graphic is a visual element composed of a geometry, symbol, and attributes that is displayed on a map or scene.Learn more in one or more graphics overlaysA graphics overlay is a client-side, temporary container of graphics to display on a map view or scene view.Learn more.

After creating a scene view, you typically set the sceneA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more and the cameraA camera defines the rendering viewpoint of a 3D scene in a scene view.Learn more 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 location, altitude (height), heading, and tilt.

Add a Scene to a SceneView to display it. Changes you make to the scene, such as adding, removing, or reordering layers, will immediately be reflected in the display. The GeoModel.initialViewpoint will determine 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
    var body: some View {
        SceneView(scene: scene, cameraController: orbitCameraController)
    }

A SceneView also allows you to:

• Adjust light, atmosphere, and space effects.
• Display image overlays on the scene surface.
• Lock the camera to a location or geoelementA geoelement refers to any geographic element in a map or map view that can be identified by its location to return attribute information.Learn more.
• Add analysis overlays to visualize analysis results.
• Identify and select features using a tapped location.
• Export an image of the current display.
• Apply a time extent to filter the display of features.

View error

The SceneView supports an error that helps to capture different situations and provides useful messages to help troubleshoot related problems that may arise. Ultimately, you decide what you want to do with the error. For example, you may decide to enter the information into a log for further examination as users report problems with your application.

GeoModel error

When working with SceneView there are situations that arise when the view is in a usable state, but nothing is displayed because the GeoModel is not configured correctly.

Examples

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
    // Set your API key during app initialization.
    // ArcGISEnvironment.apiKey = APIKey("<#YOUR-ACCESS-TOKEN#>")
    @State private var scene: ArcGIS.Scene = {
        // Creates a scene with a basemap style.
        let scene = Scene(basemapStyle: .arcGISTopographic)
        // Creates an elevation source with a URL.
        let worldElevationServiceURL = URL(string: "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer")!
        // Creates and adds the elevation source to the surface.
        let elevationSource = ArcGISTiledElevationSource(url: worldElevationServiceURL)
        let surface = Surface()
        surface.addElevationSource(elevationSource)
        // Adds the surface to the scene.
        scene.baseSurface = surface
        // Creates an initial viewpoint with a point and camera.
        let point = Point(x: -118.804, y: 34.027, z: 5330.0, spatialReference: .wgs84)
        let camera = Camera(location: point, heading: 355.0, pitch: 72.0, roll: 0)
        scene.initialViewpoint = Viewpoint(boundingGeometry: point, camera: camera)
        return scene
    }()

    var body: some View {
        // Displays the model's scene.
        SceneView(scene: 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
    // Set your API key during app initialization.
    // ArcGISEnvironment.apiKey = APIKey("<#YOUR-ACCESS-TOKEN#>")
    @State private var scene = Scene()

    func loadMobileScenePackage() async throws {
        // Creates a mobile scene package with a local file.
        let fileURL = Bundle.main.url(forResource: "Philadelphia", withExtension: "mspk")!
        let scenePackage = MobileScenePackage(fileURL: fileURL)
        try await scenePackage.load()
        // Gets the first map in the mobile map package.
        guard let scene = scenePackage.scenes.first else { return }
        self.scene = scene
    }

    var body: some View {
        SceneView(scene: scene)
            .task {
                do {
                    try await loadMobileScenePackage()
                } catch {
                    // Prints an error message if the map fails to load.
                    print("Error loading mobile map scene package.")
                }
            }
    }