at.adsb.receiver.sighting Documentation (EN)

main record

A receiver's batch sighting covering a configurable observation window.

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

manifest array of ref #manifestEntry Required

Lightweight list of all aircraft observed in this window.

maxLength: 1000 itemsminLength: 1 items

rawCapture blob Optional

Raw demodulated SDR frames captured during this window, in ATRX envelope format. Optional — strengthens provenance but not required.

maxSize: 2.0 MB

telemetry blob Required

Zstd-compressed JSON object keyed by ICAO hex, values are arrays of at.adsb.flight.defs#position objects.

maxSize: 2.0 MB

windowEnd string datetime Required

End of the observation window (exclusive).

windowStart string datetime Required

Start of the observation window (inclusive).

View raw schema

{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "windowStart",
      "windowEnd",
      "manifest",
      "telemetry",
      "createdAt"
    ],
    "properties": {
      "manifest": {
        "type": "array",
        "items": {
          "ref": "#manifestEntry",
          "type": "ref"
        },
        "maxLength": 1000,
        "minLength": 1,
        "description": "Lightweight list of all aircraft observed in this window."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "telemetry": {
        "type": "blob",
        "accept": [
          "application/zstd"
        ],
        "maxSize": 2000000,
        "description": "Zstd-compressed JSON object keyed by ICAO hex, values are arrays of at.adsb.flight.defs#position objects."
      },
      "windowEnd": {
        "type": "string",
        "format": "datetime",
        "description": "End of the observation window (exclusive)."
      },
      "rawCapture": {
        "type": "blob",
        "accept": [
          "application/vnd.at-adsb.raw-capture+zstd"
        ],
        "maxSize": 2000000,
        "description": "Raw demodulated SDR frames captured during this window, in ATRX envelope format. Optional — strengthens provenance but not required."
      },
      "windowStart": {
        "type": "string",
        "format": "datetime",
        "description": "Start of the observation window (inclusive)."
      }
    }
  },
  "description": "A receiver's batch sighting covering a configurable observation window."
}

manifestEntry object

An aircraft observed in this batch window.

Properties

icaoHex string Required

ICAO 24-bit hex address (uppercased).

maxLength: 6 bytesminLength: 6 bytes

View raw schema

{
  "type": "object",
  "required": [
    "icaoHex"
  ],
  "properties": {
    "icaoHex": {
      "type": "string",
      "maxLength": 6,
      "minLength": 6,
      "description": "ICAO 24-bit hex address (uppercased)."
    }
  },
  "description": "An aircraft observed in this batch window."
}