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.
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.
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.