Skip To Content

Stream layers

Stream layers are feature layers with a stream service as their data source. These layers reference real-time datasets where the observations are live. Observations can include changes to location, attributes, or both. Unlike other feature layers with services as their data source where you make explicit calls to the data, stream layers actively listen to the stream of data broadcast by the stream service.

A stream layer refreshes dynamically based on this broadcast of data. This means that you cannot work with or view data that was streamed prior to the beginning of your subscription. In most cases, features are broadcast at irregular intervals. You work with and symbolize stream layers in much the same way you work with standard feature layers.

Stream layers support point geometry only.

Add stream layers to a map or scene

You can add a stream layer to a map or scene from a portal item, directly from a server connection node, or by specifying a path.

Specify a portal item

Follow these steps to add a stream layer to a map or scene by specifying a portal item.

  1. In the Catalog pane, on the Portal tab, search for or browse to a feature layer item that references a stream layer as its source from your content, your groups, your portal, or the ArcGIS Living Atlas of the World.
  2. Right-click the item and add it to your map or scene.

Specify a server connection

Follow these steps to add a stream layer to a map or scene from a server.

  1. Confirm that you are connected to a server.
  2. In the Catalog pane, on the Project tab, expand the Servers node, and expand a connected server.
  3. Right-click a stream service Stream Service and add it to your map or scene.

Specify a path

Follow these steps to add a stream layer to a map or scene by specifying a path to the stream service.

  1. On the Map tab, in the Layer group, in the Add Data menu Add Data, click Data From Path .
  2. Type a path or URL to a stream service. For example, https://geoeventsample1.esri.com:6443/arcgis/rest/services/LABus/StreamServer.
  3. Click Add to add the stream service as a new layer in your map or scene.

Track-aware stream layers

A track-aware stream layer is one where the streaming features that correspond to a single object in the real world are linked together by a common attribute called a Track ID. For example, a stream layer representing airplanes may use a Track ID field to group together all observations of a single plane to distinguish them from the observations of a nearby plane.

When a stream layer is track aware, you specify the expiration of objects by track rather than by the total number of observations in the map or scene. You can symbolize the current observations in the track independently from the previous observations to differentiate them.

Track awareness is specified in the source stream service. You cannot make a stream layer track aware in ArcGIS Pro if its source stream service is not track aware.

Follow these steps to determine if a stream layer is track aware.

  1. In the Contents pane, right-click a stream layer and click Properties Properties.
  2. On the Layer Properties dialog box, on the Source tab, view the Is Track Aware entry. If the value is Yes, you will also see a Track ID Field entry, set to the attribute that groups together all observations of a single object (such as an airplane).

Latest archived location

A stream service may include a reference to a feature service that archives the latest observations. When a stream service with this capability is added to a map or scene as a stream layer, observations from the archived feature service are displayed immediately, and the streamed observations arrive as they are received from the stream service. Showing archived locations from a feature service in this way is particularly advantageous when working with track-aware stream layers that receive infrequent observations.

The latest archived location feature service is specified in the source stream service. You cannot add it to the stream layer in ArcGIS Pro if it is not enabled in the source stream service.

Follow these steps to determine if a stream layer is enabled to display the latest archived locations when it is added to a map or scene.

  1. In the Contents pane, right-click a stream layer and click Properties Properties.
  2. On the Layer Properties dialog box, on the Source tab, expand the Service Capabilities heading (if it's present) and view the Latest Archived Location entry to see the path to the feature service that stores the archived observations.

Related topics