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 FeatureCollection from the item.
Create a FeatureCollectionLayer, referring to the feature collection.
Add the feature collection layer to the map's OperationalLayers collection.
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
// Copyright 2018 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.using Esri.ArcGISRuntime.Data;
using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.Portal;
using Microsoft.UI.Xaml;
using System;
using System.Threading.Tasks;
namespaceArcGIS.WinUI.Samples.FeatureCollectionLayerFromPortal{
[ArcGIS.Samples.Shared.Attributes.Sample(
name: "Create feature collection layer (Portal item)",
category: "Layers",
description: "Create a feature collection layer from a portal item.",
instructions: "The feature collection is loaded from the Portal item when the sample starts.",
tags: new[] { "collection", "feature collection", "feature collection layer", "id", "item", "map notes", "portal" })]
publicpartialclassFeatureCollectionLayerFromPortal {
// Default portal item Id to load features from.privateconststring FeatureCollectionItemId = "32798dfad17942858d5eef82ee802f0b";
publicFeatureCollectionLayerFromPortal() {
InitializeComponent();
// Create the UI, setup the control references and execute initialization. Initialize();
}
privatevoidInitialize() {
// Add a default value for the portal item Id. CollectionItemIdTextBox.Text = FeatureCollectionItemId;
// Create a new map with the oceans basemap and add it to the map view. Map myMap = new Map(BasemapStyle.ArcGISOceans);
MyMapView.Map = myMap;
}
privateasync Task OpenFeaturesFromArcGISOnline(string itemId) {
try {
// Open a portal item containing a feature collection. ArcGISPortal portal = await ArcGISPortal.CreateAsync();
PortalItem collectionItem = await PortalItem.CreateAsync(portal, itemId);
// Verify that the item is a feature collection.if (collectionItem.Type == PortalItemType.FeatureCollection)
{
// Create a new FeatureCollection from the item. FeatureCollection featureCollection = new FeatureCollection(collectionItem);
// Create a layer to display the collection and add it to the map as an operational layer. FeatureCollectionLayer featureCollectionLayer = new FeatureCollectionLayer(featureCollection)
{
Name = collectionItem.Title
};
MyMapView.Map.OperationalLayers.Add(featureCollectionLayer);
}
else {
var messageDlg = new MessageDialog2("Portal item with ID '" + itemId + "' is not a feature collection.", "Feature Collection");
await messageDlg.ShowAsync();
}
}
catch (Exception ex)
{
var messageDlg = new MessageDialog2("Unable to open item with ID '" + itemId + "': " + ex.Message, "Error");
await messageDlg.ShowAsync();
}
}
privatevoidOpen_Click(object sender, RoutedEventArgs e) {
// Get the portal item Id from the user.string collectionItemId = CollectionItemIdTextBox.Text.Trim();
// Make sure an Id was entered.if (String.IsNullOrEmpty(collectionItemId))
{
var messageDlg = new MessageDialog2("Please enter a portal item ID", "Feature Collection ID");
_ = messageDlg.ShowAsync();
return;
}
// Call a function to add the feature collection from the specified portal item. _ = OpenFeaturesFromArcGISOnline(collectionItemId);
}
}
}