Skip to content
View on GitHubSample viewer app

Create a feature collection layer from a portal item.

Image of add feature collection layer from 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

  1. Create a Portal.
  2. Create the PortalItem, referring to the portal and an item ID.
  3. Verify that the item represents a feature collection.
  4. Create a FeatureCollection from the item.
  5. Create a FeatureCollectionLayer, referring to the feature collection.
  6. Add the feature collection layer to the map's operationalLayers collection.

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

AddFeatureCollectionLayerFromPortalItemViewModel.ktAddFeatureCollectionLayerFromPortalItemViewModel.ktMainActivity.ktAddFeatureCollectionLayerFromPortalItemScreen.kt
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
/* 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
 *
 *    http://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.
 *
 */

package com.esri.arcgismaps.sample.addfeaturecollectionlayerfromportalitem.components

import android.app.Application
import androidx.lifecycle.AndroidViewModel
import androidx.lifecycle.viewModelScope
import com.arcgismaps.data.FeatureCollection
import com.arcgismaps.mapping.ArcGISMap
import com.arcgismaps.mapping.BasemapStyle
import com.arcgismaps.mapping.PortalItem
import com.arcgismaps.mapping.Viewpoint
import com.arcgismaps.mapping.layers.FeatureCollectionLayer
import com.arcgismaps.portal.Portal
import com.esri.arcgismaps.sample.sampleslib.components.MessageDialogViewModel
import kotlinx.coroutines.launch

/**
 * ViewModel that loads a [FeatureCollection] from a [PortalItem] and adds a [FeatureCollectionLayer]
 * to the ArcGISMap.
 */
class AddFeatureCollectionLayerFromPortalItemViewModel(app: Application) : AndroidViewModel(app) {

    // Create a Portal pointing to ArcGIS Online and the feature collection portal item
    private val portalItem = PortalItem(
        portal = Portal("https://www.arcgis.com"),
        itemId = "32798dfad17942858d5eef82ee802f0b"
    )

    // Create a FeatureCollection from the portal item and add it to a FeatureCollectionLayer
    private val featureCollectionLayer = FeatureCollectionLayer(
        featureCollection = FeatureCollection(item = portalItem)
    )

    // Map with an ocean basemap and an initial viewpoint and add the featureCollectionLayer
    val arcGISMap = ArcGISMap(BasemapStyle.ArcGISOceans).apply {
        initialViewpoint = Viewpoint(latitude = 39.8, longitude = -98.6, scale = 10e7)
        // Add the layer to the map's operational layers
        operationalLayers.add(featureCollectionLayer)
    }

    // Message dialog view model for error reporting
    val messageDialogVM = MessageDialogViewModel()

    init {
        // Load the map which loads the portal item to then load feature collection layer
        viewModelScope.launch {
            arcGISMap.load().onFailure { messageDialogVM.showMessageDialog(it) }
        }
    }
}

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