Features and graphics

In ArcGIS Runtime, features and graphics represent real-world objects on a map or scene. Every feature and graphic has a geometry representing its shape and location and may have attributes that further describe the represented object. For example, you could use polygon features to represent land parcels and include attributes about each one such as parcel ID or owner. You could use point graphics to represent vehicle locations, including the vehicle's speed and fuel level.

GeoElement OMD.

Features and graphics both have geometry and attributes, defined by the GeoElement base class that they both implement. There are some fundamental differences, however, between features and graphics. The one you choose for implementing a specific use case may depend on how they are persisted, how it handles different geometry types and attribute schemas, and how they are symbolized and displayed. In general, graphics are best suited for the temporary display of application-specific objects that are not persisted when the application closes.

Comparison of features and graphics

The following table compares important characteristics of features and graphics.

CharacteristicFeatureGraphic
Display methodIn a feature layer in a map or scene.In a graphics overlay in a map view or scene view.
PersistenceIn a feature table in a data store (such as a database or service) or in a map or scene.In app memory only.
Geometry type (point, line, and so on)Features of different geometry types cannot exist in the same layer.Graphics of different geometry types can exist in the same graphic overlay.
AttributesFeatures in the same data store or feature layer have a common attribute schema.Each graphic may have a set of attributes unlike other graphics in the same graphic overlay.
SymbolizationSymbolized according to the renderer defined for the feature service or the feature layer.

If persisted in a feature collection table in a map or scene, the renderer can be overridden with feature-specific symbols.
Symbolized individually or according to the graphics overlay's renderer.
IdentifiableVia the map view or scene view.Via the map view or scene view.
EditableCreated, updated and deleted using feature table operationsCreated through a graphic constructor and added to the graphics overlay graphics collection. Attributes and geometry updated by reference on a graphic instance

Symbolizing features and graphics

Features and graphics are rendered on the display using a symbol. You can create a variety of symbol types, with properties such as color, size, and style that you can modify. Applying symbols can work differently for features and graphics.

  • Features must be displayed using a renderer, which is basically a collection of symbols. The renderer is applied to the layer that contains the features. A renderer can also contain logic that determines which symbol to apply to each feature based on an attribute value.
  • A graphic is more flexible. It can have a symbol applied directly, or can get its symbol from a renderer applied to the graphics overlay that contains it.

Symbols and renderers are described in the Styles and data visualization topic.

How features and graphics relate to a map or scene

Features are stored in feature tables, which are persisted in a local or online data source. A feature layer is used to display a feature table in a map or scene. Graphics are stored in memory and added to a graphics overlay at run time. Graphics overlays are added directly to a map view or scene view and display on top of all other objects in the view, including all layers in a map or scene.

Where do features come from?

Features can be hosted in an online service, stored locally in a database, saved in a map or scene, or saved as a portal item. How you access features in your app affects how you make and manage edits to them.

Feature services

A feature service provides online access to features and can be hosted by ArcGIS Enterprise or ArcGIS Online. A feature service contains one or several collections of features. If you visit the REST Services Directory page for a feature service, you'll see the collections of features it contains listed under the Layers: heading, as shown in the following image. Features of different geometry types (point, line, and polygon, in other words) cannot exist in the same collection, so it's common to see features organized according to geometry type in addition to theme.

Example of a feature server REST page.

The feature service in the example contains several datasets, including three that describe C2 Military Operations using points, lines, and areas (polygons). The number in parenthesis indicates the index position inside the feature service. To access a specific set of features, append the index position to the URL for the service. Hostile Units, for example, can be accessed at https://sampleserver6.arcgisonline.com/arcgis/rest/services/Military/FeatureServer/6.

Feature tables

Features in your ArcGIS Runtime app are stored in feature tables of which there are many types. Features that come directly from an ArcGIS feature service are stored in a service feature table, which is created using the URL for the service and index position (see the URL above). Features read from a local geodatabase are stored in a geodatabase feature table; for more information on how to create a geodatabase see Work with offline data. Static features stored in a map, scene, or portal item are stored in a feature collection table as part of a feature collection. Features from a web feature service are stored in a WFS feature table.

Since a feature service or local geodatabase can contain several sets of features (tables, in other words), you may need to create many feature tables in your ArcGIS Runtime app to represent all the datasets you need.

Types of features

Different feature table types return different feature objects. Feature tables that inherit directly from the FeatureTable base class return the object type. Feature tables which inherit from ArcGISFeatureTable have additional capabilities such as attachments, these return ArcGISFeature objects.

For increased efficiency, the ArcGISFeature object implements the Loadable pattern for asynchronous resources. When fetching features for rendering and query purposes, a minimum set of required fields are returned, such as identifiers, geometry, fields used for symbolizing, and so on. When you need all of the available fields you can simply load the feature.

Feature layers

It's not necessary to display the features you work with in your app. If you want your user to view (and interact with) features on a map or scene, however, add the feature table that contains them as a feature layer. A feature layer can display features from any type of feature table.

Features in a FeatureLayer can use different request modes, including caching of features, for efficient display on the client. You should be aware of the various feature request modes, as the caching behavior of feature layers may affect the editing experience.

Where do graphics come from?

Graphics are created at runtime and exist for the life of the application. They can be created from the results of various operations such as querying, identifying, geoprocessing, geocoding, or routing. You can create them using an external data source, but cannot be persisted. It's also common to create graphics from user interaction, such as clicks or touches on the display.

When to use features

Persistence is a built-in characteristic of features. Features are persisted in a data store such as a database, a service, a map, or a portal item. This ensures that a common set of features is available to multiple apps and users, enabling use cases that require collaborating with a consistent set of data.

Graphics are not persisted and reside in the memory of a single running app session. Graphics are created by the app at runtime and are only available until the app closes.

You can publish features as part of a feature service. Layers in a feature service can be displayed in a map or scene, symbolized in various ways, and queried using attribute, spatial, or temporal criteria. The editing functionality available in ArcGIS Runtime allows you to implement feature editing workflows in your app, including control of the types of edits made and who gets to make them.

The following example adds a new feature layer to the map based on an online data source. The symbology (renderer) used to display the layer is defined with the feature service.

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
// define an online data source (ServiceFeatureTable)
var uri = new Uri("http://sampleserver6.arcgisonline.com/arcgis/rest/services/SF311/FeatureServer/0");
var incidentsFeatureTable = new ServiceFeatureTable(uri);

// await loading of the table then check the load status
await incidentsFeatureTable.LoadAsync();
if(incidentsFeatureTable.LoadStatus == Esri.ArcGISRuntime.LoadStatus.Loaded)
{
    // create a new feature layer, pass the service feature table to the constructor
    var incidentsLayer = new Esri.ArcGISRuntime.Mapping.FeatureLayer(incidentsFeatureTable);

    // add the feature layer to the map
    MyMapView.Map.OperationalLayers.Add(incidentsLayer);
}

Points from a feature layer displayed on a streets basemap.

When to use graphics

Apps create graphics as needed, and graphics do not need to be persisted. Therefore, graphics are ideal for displaying things that are specific to the session, or anything that is displayed only temporarily. For example, the results of some tasks are returned as graphics, which your app may display on a graphics overlay.

The following are some common uses for graphics:

  • Display text on top of a map or scene
  • Highlight a section of the map or scene by overlaying a polygon graphic
  • Display results from spatial analysis, such as buffer polygons created around features
  • Display a route between two locations
  • Display geometry drawn interactively by the user, perhaps as input to an analysis operation
  • Animate objects that change quickly, such as moving vehicles

The following example adds a provided polyline geometry as a graphic to a graphics overlay in the map view. The symbol for the graphic is created and applied explicitly.

                   
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
private void DrawLineGraphic(Polyline polylineShape)
{
    // get the first graphics overlay in the map view
    var myGraphics = MyMapView.GraphicsOverlays[0];

    // define a line symbol (dashed blue)
    var lineSymbol = new SimpleLineSymbol();
    lineSymbol.Color = Color.Blue;
    lineSymbol.Style = SimpleLineSymbolStyle.Dash;
    lineSymbol.Width = 2;

    // create a new graphic; set the Geometry and Symbol
    var lineGraphic = new Esri.ArcGISRuntime.UI.Graphic();
    lineGraphic.Geometry = polylineShape;
    lineGraphic.Symbol = lineSymbol;

    // add the graphic to the graphics overlay
    myGraphics.Graphics.Add(lineGraphic);
}

Line graphic over a streets basemap.

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