Add features
Add features to a feature layer.
Use case
An end-user performing a survey may want to add features to the map during the course of their work.
How to use the sample
Click on a location on the map to add a feature at that location.
How it works
A Feature
instance is added to a ServiceFeatureTable
which then pushes that new feature to the server.
- Create a
ServiceFeatureTable
from a URL. - Create a
FeatureLayer
derived from theServiceFeatureTable
instance. - Create a
Feature
with attributes and a location using theServiceFeatureTable
. - Add the
Feature
to theServiceFeatureTable
. - Apply edits to the
ServiceFeatureTable
which will upload the new feature to the online service.
Relevant API
- Feature
- FeatureEditResult
- FeatureLayer
- ServiceFeatureTable
Tags
edit, feature, online service
Sample Code
<UserControl
x:Class="ArcGISRuntime.UWP.Samples.AddFeatures.AddFeatures"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:esriUI="using:Esri.ArcGISRuntime.UI.Controls">
<Grid>
<esriUI:MapView x:Name="MyMapView" />
<Border Style="{StaticResource BorderStyle}">
<TextBlock Text="Tap to add features."
TextAlignment="Center"
FontWeight="SemiBold" />
</Border>
</Grid>
</UserControl>
// Copyright 2019 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.Geometry;
using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.UI.Controls;
using System;
using Windows.UI.Popups;
namespace ArcGISRuntime.UWP.Samples.AddFeatures
{
[ArcGISRuntime.Samples.Shared.Attributes.Sample(
name: "Add features",
category: "Data",
description: "Add features to a feature layer.",
instructions: "Click on a location on the map to add a feature at that location.",
tags: new[] { "edit", "feature", "online service" })]
public partial class AddFeatures
{
// URL to the feature service.
private const string FeatureServiceUrl = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/DamageAssessment/FeatureServer/0";
// Hold a reference to the feature table.
private ServiceFeatureTable _damageFeatureTable;
public AddFeatures()
{
InitializeComponent();
Initialize();
}
private void Initialize()
{
// Create the map with streets basemap.
MyMapView.Map = new Map(Basemap.CreateStreets());
// Create the feature table, referring to the Damage Assessment feature service.
_damageFeatureTable = new ServiceFeatureTable(new Uri(FeatureServiceUrl));
// Create a feature layer to visualize the features in the table.
FeatureLayer damageLayer = new FeatureLayer(_damageFeatureTable);
// Add the layer to the map.
MyMapView.Map.OperationalLayers.Add(damageLayer);
// Listen for user taps on the map - this will select the feature.
MyMapView.GeoViewTapped += MapView_Tapped;
// Zoom to the United States.
MyMapView.SetViewpointCenterAsync(new MapPoint(-10800000, 4500000, SpatialReferences.WebMercator), 3e7);
}
private async void MapView_Tapped(object sender, GeoViewInputEventArgs e)
{
try
{
// Create the feature.
ArcGISFeature feature = (ArcGISFeature) _damageFeatureTable.CreateFeature();
// Get the normalized geometry for the tapped location and use it as the feature's geometry.
MapPoint tappedPoint = (MapPoint) GeometryEngine.NormalizeCentralMeridian(e.Location);
feature.Geometry = tappedPoint;
// Set feature attributes.
feature.SetAttributeValue("typdamage", "Minor");
feature.SetAttributeValue("primcause", "Earthquake");
// Add the feature to the table.
await _damageFeatureTable.AddFeatureAsync(feature);
// Apply the edits to the service.
await _damageFeatureTable.ApplyEditsAsync();
// Update the feature to get the updated objectid - a temporary ID is used before the feature is added.
feature.Refresh();
// Confirm feature addition.
await new MessageDialog($"Created feature {feature.Attributes["objectid"]}", "Success!").ShowAsync();
}
catch (Exception ex)
{
await new MessageDialog(ex.ToString(), "Error adding feature").ShowAsync();
}
}
}
}