Lexicon Garden

com.airplaneian.contrail.temp.flight

An assertion that a particular flight existed, rather than a personal log entry about the author. Only 'createdAt' is required. Every other field is optional, and absent means unknown or not applicable rather than empty or zero. The exception is 'relationship', where absent means no claim is being made. Records of the same flight written by different people are expected, so write the identifying fields consistently. Any kind of flying is in scope, and origin may equal destination.

Repository @airplaneian.com did:plc:5jsivedaksbcc4n2epiegflk namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authoritytemp.contrail.airplaneian.com
Indexed
Compare Edit in builder → Fork →

Record

record · key tid

Properties

actualGateArrival

string · datetime

Actual 'in' time, reaching the gate or parking position. Explicit UTC offset, no fractional seconds.

actualGateDeparture

string · datetime

Actual 'out' time, leaving the gate or parking position. Explicit UTC offset, no fractional seconds.

actualLanding

string · datetime

Actual 'on' time, wheels on. Explicit UTC offset, no fractional seconds.

actualTakeoff

string · datetime

Actual 'off' time, wheels off. Explicit UTC offset, no fractional seconds.

aircraftType

string

Free-text aircraft type as the source expressed it, for example 'Boeing 737-800'. Not normalised and not reliable for matching. Several distinct ICAO designators can share one marketing name.

  • maxLength: 128

cabin

string

Cabin or class of service. An open string in lower camel case; the known values are not exhaustive.

  • maxLength: 64
  • knownValues: economy | premiumEconomy | business | first

callsign

string

The flight identification the aircraft broadcast, uppercase and exactly as transmitted. Holds the whole callsign, never a fragment of one. May be an operator designator followed by a flight number, a registration, or a string with no internal structure.

  • maxLength: 16

createdAt

requiredstring · datetime

When this record was written, not when the flight happened. Explicit UTC offset, no fractional seconds.

date

string

Calendar date of departure at the origin, as 'YYYY-MM-DD'. Part of the identity key with 'operator' and 'flightNumber'. Must agree with any departure timestamp.

  • maxLength: 10

destination

ref

Where the flight arrived, or was intended to arrive if it was cancelled. If it diverted, this stays the intended destination and 'diversionAirport' holds where it landed.

Reference

diversionAirport

ref

Where the flight actually landed, when that was not 'destination'. Present only when 'status' is 'diverted'.

Reference

flightNumber

string

The operating agency's flight number, as a string. Digits only, without the operator prefix.

  • maxLength: 16

icao24

string

The airframe's 24-bit ICAO address, six lowercase hexadecimal characters. With an actual departure time this is the identity key for flights with no flight number.

  • maxLength: 8

icaoTypeDesignator

string

ICAO aircraft type designator, for example 'B77W'.

  • maxLength: 8

marketingAirline

string

ICAO designator of the airline that sold the flight, when it differs from 'operator'. Codeshares only.

  • maxLength: 8

marketingFlightNumber

string

Flight number under which the flight was sold, when it differs from 'flightNumber'.

  • maxLength: 16

notes

string

Free-text note. Public as soon as the record is written, and copies may persist after the record is deleted. Do not put booking references or other credentials here.

  • maxLength: 10000
  • maxGraphemes: 1000

operator

string

ICAO designator of the agency that operated the flight, three letters, uppercase. Not airlines only: 'UAL', 'FDX', 'RCH'. Use 'operatorName' where no designator exists.

  • maxLength: 8

operatorName

string

Free-text name of the operating agency, for operators with no ICAO designator. Not reliable for matching. This is who flew the aircraft, which is often not who owns it.

  • maxLength: 128

origin

ref

Where the flight departed. May equal 'destination'; local flights are ordinary.

Reference

registeredOwner

string

Free-text name of the party the airframe is registered to. Often a trust or holding company, and frequently not the operator.

  • maxLength: 128

registration

string

Registration or tail number, uppercase with no hyphens or spaces, so that 'G-VBOW' and 'GVBOW' are one aircraft. Military and state identifiers go here too.

  • maxLength: 16

relationship

string

The author's connection to this flight. Absent means no claim is being made, unlike every other field where absent means unknown. An open string: the known values are not exhaustive.

  • maxLength: 64
  • knownValues: passenger | pic | sic | student | instructor | crew | observer

route

string

The route as filed, written as the flight plan expressed it, for example 'SSTIK2 SSTIK Q90 AVOSE'. Free text, not normalised and not reliable for matching. This is the planned route, not the flown track: a track belongs in a surveillance archive, which 'icao24' and a departure time are enough to query.

  • maxLength: 1000

scheduledGateArrival

string · datetime

Scheduled 'in' time, reaching the gate or parking position. Explicit UTC offset, no fractional seconds.

scheduledGateDeparture

string · datetime

Scheduled 'out' time, leaving the gate or parking position. Explicit UTC offset, no fractional seconds.

scheduledLanding

string · datetime

Scheduled 'on' time, wheels on. Explicit UTC offset, no fractional seconds.

scheduledTakeoff

string · datetime

Scheduled 'off' time, wheels off. Explicit UTC offset, no fractional seconds.

seat

string

Seat occupied, as a string, for example '14C'.

  • maxLength: 16

source

string

Short identifier for the tool or dataset that wrote this record, for example 'flighty', 'manual', or 'adsb'.

  • maxLength: 64

sourceId

string

That tool's own identifier for this flight. Kept in the record body rather than the record key, so a record can be corrected without becoming a new one. Meaningful only with 'source'.

  • maxLength: 512

status

string

How the flight concluded. Absent means unknown, so write 'normal' explicitly when the flight operated as planned.

  • maxLength: 32
  • knownValues: normal | cancelled | diverted

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • com.airplaneian.contrail.temp.trip

    record

    An assertion that a set of flights belonged to one journey. Only 'createdAt' is required, and absent means unknown or not applicable. The reference points one way only, from trip to flight, and a trip references only flight records the author wrote.

  • com.airplaneian.contrail.temp.defs

    An airport, airfield, or landing site referenced by a flight record. Every field is optional, and absent means unknown or not applicable. The identifier fields come from different systems and a place may have any combination of them, so write each one the place actually has. A place with no published identifier is described by 'name' and 'geo' alone.

  • at.adsb.aircraft.identity

    record

    An aircraft identified by its ICAO 24-bit address. Stores static identity and registration information. Created on first sighting by a receiver.

  • at.adsb.flight.record

    record

    A receiver-authored record of an aircraft's transit through the receiver's coverage area. Created on departure. References all contributing batch sightings and the aircraft identity via strongRef for provenance verification.