Stream Services

URL:
https://<root>/<serviceName>/StreamServer
Methods:
GET
Operations:
Broadcast, Subscribe
Required Capability:
Streaming
Version Introduced:
10.3

Description

A stream service is a type of ArcGIS GeoEvent Server service that emphasizes low latency and real-time data dissemination for client and server data flows.

ArcGIS GeoEvent Server must be licensed and installed in your enterprise GIS to use stream services. Stream service content can be used in ArcGIS Online and ArcGIS Enterprise web maps or clients developed using the ArcGIS Maps SDK for JavaScript. See Introduction to ArcGIS GeoEvent Server for more information.

Hosting a stream service on ArcGIS GeoEvent Server allows administrators to broadcast event data over the stream service and enables clients to subscribe to a stream service and immediately begin receiving data.

The REST API stream service resource provides basic information about the service including event attribute fields, geometry type, and WebSocket resources used by the service.

See Stream services for more information.

Request parameters

ParameterDetails

f

The response format. The default response format is html.

Values: html | json | jsapi

Example usage

The following is a sample request URL used to query a hypothetical service named AircraftLocations on a local ArcGIS GeoEvent Server:

Use dark colors for code blocksCopy
1
https://<machineName>.<domain>.com/webadaptor/rest/services/AircraftLocations/StreamServer?f=pjson

JSON Response example

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
{
  "currentVersion": "10.3",
  "description": "Flights",
  "objectIdField": null,
  "timeInfo": {
    "trackIdField": "AircraftId",
    "startTimeField": null,
    "endTimeField": null
  },
  "geometryType": "esriGeometryPoint",
  "geometryField": "Location",
  "spatialReference": {
    "wkid": 4326,
    "latestWkid": 4326
  },
  "drawingInfo": {
    "renderer": {
      "type": "simple",
      "description": "",
      "symbol": {
        "type": "esriSMS",
        "style": "esriSMSCircle",
        "color": [
          5,
          112,
          176,
          204
        ],
        "size": 10,
        "angle": 0,
        "xoffset": 0,
        "yoffset": 0,
        "outline": {
          "color": [
            255,
            255,
            255,
            255
          ],
          "width": 1
        }
      }
    }
  },
  "fields": [
    {
      "name": "FltId",
      "type": "esriFieldTypeString",
      "alias": "FltId",
      "nullable": true
    },
    {
      "name": "DepArpt",
      "type": "esriFieldTypeString",
      "alias": "DepArpt",
      "nullable": true
    },
    {
      "name": "MsgTime",
      "type": "esriFieldTypeDate",
      "alias": "MsgTime",
      "nullable": true
    },
    {
      "name": "Heading",
      "type": "esriFieldTypeInteger",
      "alias": "Heading",
      "nullable": true
    },
    {
      "name": "AltitudeFeet",
      "type": "esriFieldTypeInteger",
      "alias": "AltitudeFeet",
      "nullable": true
    },
    {
      "name": "FID",
      "type": "esriFieldTypeInteger",
      "alias": "FID",
      "nullable": true
    }
  ],
		// if snapshot archiving was enabled during publishing
  "keepLatestArchive": {
    "featuresUrl": "https://host:port/arcgis/rest/services/FltArc/FeatureServer/0",
    "updateInterval": 10,
    "maximumFeatureAge": 60,
    "datastore": null
  },
  // if related features service URL was specified during publishing
  "relatedFeatures": {
    "featuresUrl": "https://host:port/arcgis/rest/services/FltLoc/FeatureServer/0",
    "joinField": "FltId"
  },
  "streamUrls": [
    {
      "transport": "ws",
      // An access token with an expiration of 5 minutes if the service is secured
      "token": "kAZQCVDbCHCiWk9__LOBgwa6fjw6uDbqh",
      "urls": [
        "ws(s)://machine:port/arcgis/ws/services/Flights/StreamServer"
      ]
    }
  ],
  "capabilities": "broadcast,subscribe"
}

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