Group layers together

View on GitHub

Group a collection of layers together and toggle their visibility as a group.

Image of group layers together

Use case

Group layers communicate to the user that layers are related and can be managed together. In a land development project, you might group layers according to the phase of development.

How to use the sample

The layers in the map will be displayed in a table of contents. For project area group layers, toggle the switch next to a layer's name. For the buildings group layers, tap the cell to change its visibility. Turning a group layer's visibility off will override the visibility of its child layers.

How it works

  1. Create an empty GroupLayer.
  2. Add a child layer to the group layer's layers collection.
  3. Set the group layer's visibilityMode to change its behavior:
  • independent allows each sublayer to change its visibility independently.
  • exclusive allows only one sublayer to be visible at a time.
  • inherited treats the group layer as if it is one merged layer.
  1. To toggle the visibility of the group, simply change the group layer's isVisible property.

Relevant API

  • GroupLayer

Additional information

The full extent of a group layer may change when child layers are added/removed. Group layers do not have a spatial reference, but the full extent will have the spatial reference of the first child layer.

Group layers can be saved to web scenes. In web maps, group layers will be ignored.

Tags

group layer, layers

Sample Code

GroupLayersTogetherView.swiftGroupLayersTogetherView.swiftGroupLayersTogetherView.GroupLayerListView.swift
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
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
166
167
168
169
170
171
172
173
// Copyright 2023 Esri
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//   https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

import ArcGIS
import SwiftUI

struct GroupLayersTogetherView: View {
    /// A scene with an imagery basemap and a world elevations source.
    @State private var scene: ArcGIS.Scene = {
        let scene = Scene(basemapStyle: .arcGISImagery)

        // Add base surface to the scene for elevation data.
        let elevationSource = ArcGISTiledElevationSource(url: .worldElevationService)
        let surface = Surface()
        surface.addElevationSource(elevationSource)
        scene.baseSurface = surface
        return scene
    }()

    /// The current viewpoint of the scene view.
    @State private var viewpoint: Viewpoint?

    /// A Boolean value that indicates whether the layers sheet is showing.
    @State private var isShowingLayersSheet = false

    var body: some View {
        SceneView(scene: scene, viewpoint: viewpoint)
            .onViewpointChanged(kind: .centerAndScale) { viewpoint = $0 }
            .task {
                // Add group layers to the scene as operational layers.
                scene.addOperationalLayers([makeProjectAreaGroupLayer(), makeBuildingsGroupLayer()])

                // Ensure all group layers' childlayers are loaded.
                for groupLayer in scene.operationalLayers as! [GroupLayer] {
                    await groupLayer.layers.load()
                }

                // Set the scene's viewpoint with the extent of the project area group layer.
                if let extent = scene.operationalLayers.first?.fullExtent {
                    let camera = Camera(lookingAt: extent.center, distance: 700, heading: 0, pitch: 60, roll: 0)
                    viewpoint = Viewpoint(latitude: .nan, longitude: .nan, scale: .nan, camera: camera)
                }
            }
            .toolbar {
                ToolbarItem(placement: .bottomBar) {
                    Button("Layers") {
                        isShowingLayersSheet = true
                    }
                    .popover(isPresented: $isShowingLayersSheet) {
                        layersList
                            .presentationDetents([.fraction(0.5)])
                            .frame(idealWidth: 320, idealHeight: 380)
                    }
                }
            }
    }

    /// The list of group layers and their child layers that are currently added to the map.
    @MainActor private var layersList: some View {
        NavigationStack {
            List {
                ForEach(scene.operationalLayers as! [GroupLayer], id: \.name) { groupLayer in
                    GroupLayerListView(groupLayer: groupLayer)
                }
            }
            .navigationTitle("Layers")
            .navigationBarTitleDisplayMode(.inline)
            .toolbar {
                ToolbarItem(placement: .confirmationAction) {
                    Button("Done") {
                        isShowingLayersSheet = false
                    }
                }
            }
        }
    }
}

extension GroupLayersTogetherView {
    /// Creates the project area group layer from individual child layers.
    /// - Returns: A `GroupLayer` object.
    private func makeProjectAreaGroupLayer() -> GroupLayer {
        // Create a group layer and set its name.
        let groupLayer = GroupLayer()
        groupLayer.name = "Project area group"

        // Create a scene layer for the trees.
        let treesLayer = ArcGISSceneLayer(url: .trees)

        // Create a feature layer for the pathways.
        let pathwaysTable = ServiceFeatureTable(url: .pathways)
        let pathwaysLayer = FeatureLayer(featureTable: pathwaysTable)
        pathwaysLayer.sceneProperties.altitudeOffset = 1
        pathwaysLayer.sceneProperties.surfacePlacement = .relative

        // Create a feature layer for the project area.
        let projectAreaTable = ServiceFeatureTable(url: .projectArea)
        let projectAreaLayer = FeatureLayer(featureTable: projectAreaTable)

        // Add the scene and feature layers as children of the group layer.
        groupLayer.addLayers([treesLayer, pathwaysLayer, projectAreaLayer])
        return groupLayer
    }

    /// Creates the buildings group layer from individual child layers.
    /// - Returns: A `GroupLayer` object.
    private func makeBuildingsGroupLayer() -> GroupLayer {
        // Create a group layer and set its name.
        let groupLayer = GroupLayer()
        groupLayer.name = "Buildings group"

        // Create layers for the buildings.
        let buildingsALayer = ArcGISSceneLayer(url: .buildingsA)
        let buildingsBLayer = ArcGISSceneLayer(url: .buildingsB)

        // Add the scene layers as children of the group layer.
        groupLayer.addLayers([buildingsALayer, buildingsBLayer])

        // Set the visibility mode to exclusive so only one sublayer can be visible
        // at a time.
        groupLayer.visibilityMode = .exclusive
        return groupLayer
    }
}

private extension URL {
    /// A URL for a world elevation service from Terrain3D ArcGIS REST service.
    static var worldElevationService: URL {
        URL(string: "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer")!
    }

    /// A URL for the tress scene service.
    static var trees: URL {
        URL(string: "https://tiles.arcgis.com/tiles/P3ePLMYs2RVChkJx/arcgis/rest/services/DevA_Trees/SceneServer")!
    }

    /// A URL for the pathways feature service.
    static var pathways: URL {
        URL(string: "https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/DevA_Pathways/FeatureServer/1")!
    }

    /// A URL for the project area feature service.
    static var projectArea: URL {
        URL(string: "https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/DevelopmentProjectArea/FeatureServer/0")!
    }

    /// A URL for the buildings A scene service.
    static var buildingsA: URL {
        URL(string: "https://tiles.arcgis.com/tiles/P3ePLMYs2RVChkJx/arcgis/rest/services/DevA_BuildingShells/SceneServer")!
    }

    /// A URL for the buildings B scene service.
    static var buildingsB: URL {
        URL(string: "https://tiles.arcgis.com/tiles/P3ePLMYs2RVChkJx/arcgis/rest/services/DevB_BuildingShells/SceneServer")!
    }
}

#Preview {
    NavigationStack {
        GroupLayersTogetherView()
    }
}

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