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.

---

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, PARA_GLIDER, HAND_GLIDER, HELICOPTER, UAV, etc.
transponderType	string	No	The type of transponder broadcasting the position. Allowable values: ADS-BI, FLARM, ADS-B, etc.