gRPC
The streaming API exposes one data-plane service, AircraftStreamingService, whose StartStream RPC opens the live feed and accepts an optional filter. The SubscriptionService described below is Deprecated. Field-level detail for the JSON payload is on the Aircraft page.
Aircraft
The aircraft.proto contract — open a streaming connection and receive aircraft batches.
Subscription
Deprecated — set filters on StartStream instead. The subscription.proto contract and its UpdateSubscription RPC will be removed in a future release.
Service definitions
Services
AircraftStreamingService
Service definition for streaming aircraft data
StartStream
JSON-based streaming (high throughput, no protobuf conversion)
- Request:
StartStreamRequest - Response:
JsonAircraftBatch(streaming)
SubscriptionService
UpdateSubscription
Deprecated: replaces the filter on the subscription's open stream at the gateway's next revalidation pass. Does not survive a reconnect. Prefer StartStreamRequest.filters and reconnect to change it.
- Request:
UpdateSubscriptionRequest - Response:
Subscription
Messages
Filter
root_group—FilterGroup
FilterCondition
| Field | Type | Description |
|---|---|---|
field | string | e.g. "altitude", "hex" |
op | string | e.g. "EQ", "GT", "IN" |
value | string | condition value, always passed as a string regardless of the underlying field's type |
FilterGroup
| Field | Type | Description |
|---|---|---|
op | FilterGroup.LogicalOperator | |
conditions | FilterCondition (repeated) | |
groups | FilterGroup (repeated) |
JsonAircraftBatch
JSON-based batch for high-throughput streaming (avoids protobuf conversion overhead)
json_data—bytes— JSON array of aircraft position objects
StartStreamRequest
Request to start streaming aircraft for a subscription
| Field | Type | Description |
|---|---|---|
subscription_id | string | |
filters | jetnet.streaming.Filter | Optional. The filter for this connection. Omit or send empty for an unfiltered stream. Nothing from a previous connection carries over. |
Subscription
| Field | Type | Description |
|---|---|---|
id | string | |
client_id | string | |
name | string | |
filters | Filter | |
topic_name | string | Convenience fields |
UpdateSubscriptionRequest
| Field | Type | Description |
|---|---|---|
subscription_id | string | |
name | string | optional |
filters | Filter | optional; full replacement semantics |
Enums
FilterGroup.LogicalOperator
| Value | Number | Description |
|---|---|---|
LOGICAL_OPERATOR_UNSPECIFIED | 0 | |
AND | 1 | |
OR | 2 |