Skip to main content

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. This is your UAV telemetry you are submitting to SafeSky.

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 Altitude of the UAV in metersmeters, (based on GPS AMSL).altitude AMSL. Value "-9999"9999 means unknown.
last_updatealtitude_accuracy longint YesNo TimeAccuracy level of the eventaltitude coordinate in secondsmeters.
since epoch(UTC-0).accuracy int No Accuracy level of the latitude and longitude coordinates in meters. call_sign string No UAV call-sign. ground_speed 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 CurrentThe status:current status of the UAV. Allowable values: INACTIVE, AIRBORNE, GROUNDED. last_update long Yes The time of the event in seconds since epoch at UTC-0. turn_rate float No Turn rate in degrees per second. vertical_rate int No Vertical rate in meters per second. A positive value indicates climbing, a negative value indicates descent. icao24 string No Unique ICAO 24-bit address of the transponder in hex string representation.

2. Beacon Model

The Beacon model representsdefines allthe detectedstructure of an aircraft inbeacon as provided by SafeSky. This is the vicinity.traffic as returned by SafeSky.

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 Altitude of the beacon in meters, based on GPS altitude AMSL. altitude_accuracy int No Accuracy level of the altitude coordinate in meters. accuracy int No Accuracy level of the latitude and longitude coordinates in meters. call_sign string No Beacon call-sign, available only if the pilot has a public profile. ground_speed 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: INACTIVE, AIRBORNE, GROUNDED. last_update long Yes The time of the event in seconds since epoch at UTC-0. turn_rate float No Turn rate in degrees per second. vertical_rate int No Vertical rate in meters per second. beacon_type string No Values:Allowable values: UNKNOWN, GLIDER, PARA_GLIDER, HELICOPTER, UAV, PARACHUTE, MOTORPLANE, JET, etc.AIRSHIP, BALLOON, GYROCOPTER, FLEX_WING_TRIKES, PARA_MOTOR, THREE_AXES_LIGHT_PLANE, PAV, MILITARY, STATIC_OBJECT. operation_area GeoJson No PolygonWhen beacon_type is an ADVISORY, this represents the polygon for the area of operationoperation. (Advisories only). remarks string No Free text comment when applicable.

Example Payload:

[
    {
        "latitude": 50.70716,
        "longitude": 4.36613,
        "accuracy": 3645,
        "call_sign": "ADVISORY TEST",
        "transponder_type": "ADVISORY",
        "last_update": 1764171645,
        "altitude": 111,
        "remarks": "Inspection powerlines",
        "status": "AIRBORNE",
        "beacon_type": "UAV",
        "id": "my_advisory_id1"
    }
]
Back to top