Add dynamic entity layer

View on GitHub

Display data from an ArcGIS stream service using a dynamic entity layer.

Image of add dynamic entity layer Image of add dynamic entity layer settings

Use case

A stream service is a type of service provided by ArcGIS Velocity and GeoEvent Server that allows clients to receive a stream of data observations via a web socket. ArcGIS Maps SDK allows you to connect to a stream service and manage the information as dynamic entities and display them in a dynamic entity layer. Displaying information from feeds such as a stream service is important in applications like dashboards where users need to visualize and track updates of real-world objects in real-time.

Use ArcGISStreamService to manage the connection to the stream service and purge options to manage how much data is stored and maintained by the application. The dynamic entity layer will display the latest received observation, and you can set track display properties to determine how to display historical information for each dynamic entity. This includes the number of previous observations to show, whether to display track lines in-between previous observations, and setting renderers.

How to use the sample

Use the controls to connect to or disconnect from the stream service, modify display properties in the dynamic entity layer, and purge all observations from the application.

How it works

  1. Create an ArcGIStreamService using a stream service URL.
  2. Set an ArcGISStreamServiceFilter on the stream service to limit the amount of data coming from the server.
  3. Set the maximumDuration property of the stream service's purgeOptions to limit the amount of data managed by the application.
  4. Create a DynamicEntityLayer using the stream service.
  5. Update values in the layer's trackDisplayProperties to customize the layer's appearance.
  6. Add the DynamicEntityLayer to the map.
  7. Use the onSingleTapGesture modifier and call MapViewProxy.identify(on:screenPoint:tolerance:returnPopupsOnly:maximumResults:) to select a dynamic entity and display the entity's attributes in a callout.

Relevant API

  • ArcGISStreamService
  • ArcGISStreamServiceFilter
  • ConnectionStatus
  • DynamicEntity
  • DynamicEntityDataSource.PurgeOptions
  • DynamicEntityLayer
  • TrackDisplayProperties

About the data

This sample uses a stream service that simulates live data coming from snowplows near Sandy, Utah. There are multiple vehicle types and multiple agencies operating the snowplows.

Tags

data, dynamic, entity, live, purge, real-time, service, stream, track

Sample Code

AddDynamicEntityLayerView.swiftAddDynamicEntityLayerView.swiftAddDynamicEntityLayerView.Model.swiftAddDynamicEntityLayerView.SettingsView.swiftAddDynamicEntityLayerView.VehicleCallout.swift
Use dark colors for code blocksCopy
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
// Copyright 2023 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
//
//   https://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.

import SwiftUI
import ArcGIS

struct AddDynamicEntityLayerView: View {
    /// The view model for the sample.
    @StateObject private var model = Model()

    /// A Boolean value indicating whether the settings view should be presented.
    @State private var isShowingSettings = false

    /// The initial viewpoint for the map.
    @State private var viewpoint = Viewpoint(
        center: Point(x: -12452361.486, y: 4949774.965),
        scale: 200_000
    )

    /// The callout placement.
    @State private var placement: CalloutPlacement?

    /// A Boolean value indicating if the stream service is connected.
    var isConnected: Bool {
        model.streamService.connectionStatus == .connected
    }

    var body: some View {
        MapViewReader { proxy in
            MapView(map: model.map, viewpoint: viewpoint)
                .callout(placement: $placement) { placement in
                    VehicleCallout(dynamicEntity: placement.geoElement as! DynamicEntity)
                }
                .onSingleTapGesture { screenPoint, _ in
                    placement = nil
                    Task {
                        guard let result = try? await proxy.identify(on: model.dynamicEntityLayer, screenPoint: screenPoint, tolerance: 12),
                              let observation = result.geoElements.first as? DynamicEntityObservation,
                              let entity = observation.dynamicEntity
                        else {
                            return
                        }
                        placement = .geoElement(entity)
                    }
                }
                .toolbar {
                    ToolbarItemGroup(placement: .bottomBar) {
                        Button(isConnected ? "Disconnect" : "Connect") {
                            Task {
                                if isConnected {
                                    await model.streamService.disconnect()
                                } else {
                                    try? await model.streamService.connect()
                                }
                            }
                        }
                        Spacer()
                        settingsButton
                    }
                }
                .overlay(alignment: .top) {
                    HStack {
                        Text("Status:")
                        Text(model.connectionStatus)
                            .italic()
                    }
                    .frame(maxWidth: .infinity)
                    .padding(.vertical, 6)
                    .background(.thinMaterial, ignoresSafeAreaEdges: .horizontal)
                }
                .task {
                    // This will update `connectionStatus` when the stream service
                    // connection status changes.
                    for await status in model.streamService.$connectionStatus {
                        model.connectionStatus = status.description
                    }
                }
        }
    }

    @ViewBuilder private var settingsButton: some View {
        let button = Button("Dynamic Entity Settings") {
            isShowingSettings = true
        }
        let settingsView = SettingsView(model: model, calloutPlacement: $placement)

        if #available(iOS 16, *) {
            button
                .popover(isPresented: $isShowingSettings, arrowEdge: .bottom) {
                    settingsView
                        .presentationDetents([.fraction(0.5)])
#if targetEnvironment(macCatalyst)
                        .frame(minWidth: 300, minHeight: 270)
#else
                        .frame(minWidth: 320, minHeight: 390)
#endif
                }
        } else {
            button
                .sheet(isPresented: $isShowingSettings, detents: [.medium]) {
                    settingsView
                }
        }
    }
}

#Preview {
    NavigationView {
        AddDynamicEntityLayerView()
    }
}

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