Create a feature collection layer from a portal item.
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
FeatureCollectionfrom 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.
Tags
collection, feature collection, feature collection layer, id, item, map notes, portal
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: 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()
}