Class DynamicEntityLayer
A Layer that displays dynamic entity observations from real-time services.
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
Target | Versions |
---|---|
.NET Standard 2.0 | 200.3 - 200.5 |
.NET | 200.3 - 200.5 |
.NET Windows | 200.3 - 200.5 |
.NET Android | 200.3 - 200.5 |
.NET iOS | 200.3 - 200.5 |
.NET Framework | 200.3 - 200.5 |
UWP | 200.3 - 200.5 |