Add feature collection layer from portal item | ArcGIS Maps SDK for Swift

View on GitHub

Create a feature collection layer from a portal item.

Image of Add feature collection layer from portal item sample

Use case

Feature collection layers are often used to hold features with mixed geometry or unstructured data. You can display feature collections stored in a Portal, which are often used for showing content from a CSV or map notes.

How to use the sample

The feature collection is loaded from the Portal item when the sample starts.

How it works

Create a Portal.
Create the PortalItem, referring to the portal and an item ID.
Verify that the item represents a feature collection.
Create a FeatureCollection from the item.
Create a FeatureCollectionLayer, referring to the feature collection.
Add the feature collection layer to the map’s operational layers.

Relevant API

FeatureCollection
FeatureCollectionLayer
Portal
PortalItem

About the data

The sample uses a sample layer depicting World Cities Population Rank.

Sample code

AddFeatureCollectionLayerFromPortalItemView.swift

// Copyright 2025 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 AddFeatureCollectionLayerFromPortalItemView: View {
    /// A map with an ocean basemap style.
    @State private var map = Map(basemapStyle: .arcGISOceans)

    /// The error shown in the error alert.
    @State private var error: (any Error)?

    var body: some View {
        MapView(map: map)
            .task {
                // Creates a portal item with portal item ID.
                let portalItem = PortalItem(
                    portal: .arcGISOnline(connection: .anonymous),
                    id: PortalItem.ID("32798dfad17942858d5eef82ee802f0b")!
                )
                do {
                    try await portalItem.load()
                    // Verifies that the item represents a feature collection.
                    if portalItem.kind == .featureCollection {
                        // Creates a feature collection from the item.
                        let featureCollection = FeatureCollection(item: portalItem)
                        // Creates a feature collection layer, referring to the
                        // feature collection.
                        let layer = FeatureCollectionLayer(featureCollection: featureCollection)
                        // Adds the feature collection layer to the map's
                        // operational layers.
                        map.addOperationalLayer(layer)
                    }
                } catch {
                    // Updates the error and shows an alert if any failure occurs.
                    self.error = error
                }
            }
            .errorAlert(presentingError: $error)
    }
}

#Preview {
    AddFeatureCollectionLayerFromPortalItemView()
}