Model Definition

Model Definition

1. UAV Model

The UAV model defines the structure and attributes of an Unmanned Aerial Vehicle (UAV) as submitted to the /v1/uav endpoint.

Field (Req)	Type	Description
`id` (Yes)	`string`	The unique identifier of the UAV.
`latitude` (Yes)	`double`	Latitude in decimal degrees.
`longitude` (Yes)	`double`	Longitude in decimal degrees.
`altitude` (Yes)	`int`	Altitude (meters, GPS AMSL). Value `-9999` means unknown.
`altitude_accuracy`	`int`	Accuracy level of the altitude coordinate in meters.
`accuracy`	`int`	Accuracy level of the horizontal coordinates in meters.
`call_sign`	`string`	UAV call-sign.
`ground_speed`	`int`	Current ground speed (m/s).
`course`	`int`	Direction of travel (degrees, clockwise from true north).
`status`	`string`	Status: `INACTIVE`, `AIRBORNE`, `GROUNDED`.
`last_update` (Yes)	`long`	Time of event in seconds since epoch (UTC-0).
`turn_rate`	`float`	Turn rate in degrees per second.
`vertical_rate`	`int`	Vertical rate (m/s): positive = climbing, negative = descent.
`icao24`	`string`	Unique ICAO 24-bit address (hex string).

2. Beacon Model

The Beacon model defines the structure of an aircraft beacon as provided by SafeSky.

Field (Req)	Type	Description
`id` (Yes)	`string`	The unique identifier of the beacon.
`latitude` (Yes)	`double`	Latitude in decimal degrees.
`longitude` (Yes)	`double`	Longitude in decimal degrees.
`altitude` (Yes)	`int`	Altitude (meters, GPS AMSL).
`ground_speed` (Yes)	`int`	Current ground speed (m/s).
`course` (Yes)	`int`	Direction of travel (degrees, clockwise from true north).
`status`	`string`	Status: `INACTIVE`, `AIRBORNE`, `GROUNDED`.
`last_update` (Yes)	`long`	Time of event in seconds since epoch (UTC-0).
`beacon_type`	`string`	Type (e.g., `GLIDER`, `HELICOPTER`, `UAV`, `JET`).
`operation_area`	`GeoJson`	Polygon for the area of operation (Advisories only).
`remarks`	`string`	Free text comment when applicable.

Example Payload

[
    {
        "id": "my_advisory_id1",
        "latitude": 50.70716,
        "longitude": 4.36613,
        "altitude": 111,
        "ground_speed": 0,
        "course": 0,
        "last_update": 1764171645,
        "beacon_type": "UAV",
        "status": "AIRBORNE",
        "remarks": "Inspection powerlines"
    }
]

Back to top