Class DynamicEntityLayer

A Layer that displays dynamic entity observations from real-time services.

Inheritance
System.Object
Layer
DynamicEntityLayer
Implements
System.ComponentModel.INotifyPropertyChanged
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class DynamicEntityLayer : Layer, INotifyPropertyChanged, ILoadable, ILayerContent, IPopupSource
Remarks

A dynamic entity layer consumes DynamicEntityObservation objects streamed from a DynamicEntityDataSource. A DynamicEntityDataSource must be passed to the constructor of the layer. The layer manages the display of observations as they are added to or removed from the data source's local cache.

A dynamic entity layer's TrackDisplayProperties allow you to control the display of previous observations by setting a maximum number of observations to show, displaying a line that connects them (track line), and applying renderers to the observations and/or track line.

As with other layers in the ArcGIS Maps SDK, display properties are managed with renderers. In the dynamic entity layer, three renderers are used to control the display observations:

  • Renderer: the main renderer property inherited from Layer is used to control the display of the latest observation in a track. All renderer types are supported.
  • PreviousObservationRenderer: used to control the display of previous observations in a track. All renderer types are supported
  • TrackLineRenderer: used to control the display of the track line between observations. All renderer types are supported; however, the track line attributes collection includes only the entity ID attribute that uniquely identifies the track. This attribute can be used to highlight a specific track using one of the attribute-based renderers.

Labels in a dynamic entity layer are controlled through the inherited Layer labeling API. Labels only appear on the latest observation in a track and are not placed on previous observations.

The dynamic entity layer has methods for selecting or unselecting dynamic entities and observations in the display. When selecting a dynamic entity, the selection moves with the entity (the selection halo moves to the latest observation in the track) as new observations are received from the stream. Since observations are static, selected observations appear like any static GeoElement on the display.

Dynamic entity layer also supports identify behavior in a map view or scene view. Be aware that the identify results from this layer consist entirely of DynamicEntityObservation objects. Use the GetDynamicEntity() method to retrieve the DynamicEntity that the identified observation is associated with.

Constructors

Name Description
DynamicEntityLayer(DynamicEntityDataSource)

Initializes a new instance of the DynamicEntityLayer class from a DynamicEntityDataSource.

Properties

Name Description
DataSource

Gets the dynamic entity data source.
IsPopupEnabled

Gets or sets a value indicating whether the PopupDefinition defined on the DynamicEntityLayer is enabled or disabled.
LabelDefinitions

Gets a modifiable collection of LabelDefinition objects for this layer.
LabelsEnabled

Gets or sets a value indicating whether labels should be displayed.
PopupDefinition

Gets or sets the pop-up definition.
Renderer

Gets or sets the Renderer used to display the latest observation of dynamic entities.
SceneProperties

Gets or sets the scene properties for the dynamic entity layer.
TrackDisplayProperties

Gets the track display properties.

Methods

Name Description
ClearSelection()

Clears all selected dynamic entities and observations.
GetSelectedDynamicEntities()

Gets all selected dynamic entities.
GetSelectedDynamicEntityObservations()

Gets all selected dynamic entity observations.
SelectDynamicEntities(IEnumerable<DynamicEntity>)

Selects the specified dynamic entities.
SelectDynamicEntity(DynamicEntity)

Selects the given dynamic entity and adds it to the current list of selected dynamic entities.
SelectDynamicEntityObservation(DynamicEntityObservation)

Selects the given dynamic entity observation and adds it to the current list of selected observations.
SelectDynamicEntityObservations(IEnumerable<DynamicEntityObservation>)

Selects the given dynamic entity observations and adds them to the current list of selected observations.
UnselectDynamicEntities(IEnumerable<DynamicEntity>)

Unselects the specified dynamic entities and removes them from the current list of selected dynamic entities.
UnselectDynamicEntity(DynamicEntity)

Unselects the given dynamic entity and removes it from the current list of selected dynamic entities.
UnselectDynamicEntityObservation(DynamicEntityObservation)

Unselects the given dynamic entity observation and removes it from the current list of selected observations.
UnselectDynamicEntityObservations(IEnumerable<DynamicEntityObservation>)

Unselects the given dynamic entity observations and removes them from the current list of selected observations.

Applies to

TargetVersions
.NET Standard 2.0200.3 - 200.5
.NET200.3 - 200.5
.NET Windows200.3 - 200.5
.NET Android200.3 - 200.5
.NET iOS200.3 - 200.5
.NET Framework200.3 - 200.5
UWP200.3 - 200.5