Skip to main content

Model Definition

1. UAV Model

The UAV model represents the structure and attributes of an Unmanned Aerial Vehicle (UAV) as captured in the SafeSky system.

Field     Type    Required Description
id string Yes The unique identifier of the UAV.
latitude double Yes Latitude in decimal degrees.
longitude double Yes Longitude in decimal degrees.
altitude int Yes Height of the UAV in meters, based on GPS altitude AMSL.
altitudeAccuracy int No Accuracy level of the altitude coordinate in meters.
accuracy int No Accuracy level of the latitude and longitude coordinates in meters.
callSign string No UAV call-sign.
groundSpeed int No Current ground speed of the UAV, specified in meters per second.
course int No Direction of travel, specified in degrees counting clockwise relative to the true north.
status string No The current status of the UAV. Allowable values: INACTIVE, AIRBORNE, GROUNDED.
lastUpdate long Yes The time of the event in seconds since epoch at UTC-0.
turnRate float No Turn rate in degrees per second.
verticalRate int No Vertical rate in meters per second. A positive value indicates climbing, a negative value indicates descent.
icao24 string Unique ICAO 24-bit address of the transponder in hex string representation. See FAQs for more details

2. Beacon Model

The Beacon model defines the structure of an aircraft beacon, including its attributes and behavior.

Field Type Required Description
id string Yes The unique identifier of the beacon.
latitude double Yes Latitude in decimal degrees.
longitude double Yes Longitude in decimal degrees.
altitude int Yes Height of the beacon in meters, based on GPS altitude AMSL.
altitudeAccuracy int No Accuracy level of the altitude coordinate in meters.
accuracy int No Accuracy level of the latitude and longitude coordinates in meters.
callSign string No Beacon call-sign, available only if the pilot has a public profile.
groundSpeed int Yes Current ground speed of the beacon, specified in meters per second.
course int Yes Direction of travel, specified in degrees counting clockwise relative to the true north.
status string No The current status of the beacon. Allowable values: INACTIVE, AIRBORNE, GROUNDED.
lastUpdate long Yes The time of the event in seconds since epoch at UTC-0.
turnRate float No Turn rate in degrees per second.
verticalRate int No Vertical rate in meters per second. A positive value indicates climbing, a negative value indicates descent.
beaconType string No The type of the beacon. Allowable values: UNKNOWN, GLIDER, TOW_PLANE, HELICOPTER_ROTORCRAFT, PARACHUTE, DROP_PLANE, HANG_GLIDER, PARA_GLIDER, POWERED_AIRCRAFT, JET_AIRCRAFT, UFO, BALLOON, AIRSHIP, UAV, STATIC_OBJECT.
Back to top