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

sources array of string Required

Deduplicated list of decoder source types that contributed position fixes in this batch window.

maxLength: 50 itemsminLength: 1 items

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

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

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

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