BLbluestaq
Track

POST /filedrop/udl-missiletrack

Changed on

Service operation to take multiple missile track records as a POST body and ingest into the database. This operation is intended to be used for automated feeds into UDL. A specific role is required to perform this service operation. Please contact the UDL team for assistance.

Request

  • Base URL
    https://unifieddatalibrary.com
  • URL
    https://unifieddatalibrary.com/filedrop/udl-missiletrack
  • Auth
    none declared

Request body

idstring

Unique identifier of the record, auto-generated by the system if not provided on create operations.

classificationMarkingstring required

Classification marking of the data in IC/CAPCO Portion-marked format.

msgTypestring

The type of external message from which this request originated.

msgSubTypestring

The message subtype is a finer grain categorization of message types as many messages can contain a variety of data content within the same structure. Examples include but are not limited to Initial, Final, Launch, Update, etc. Users should consult the appropriate documentation, based on the message type, for the definitions of the subtypes that apply to that message.

msgCreateDatestring date-time

The timestamp of the external message from which this request originated, if applicable, in ISO8601 UTC format with millisecond precision.

env'AIR' | 'LAND' | 'SPACE' | 'SURFACE' | 'SUBSURFACE' | 'UNKNOWN'

The track environment type (AIR, LAND, SPACE, SUBSURFACE, SURFACE, UNKNOWN):

AIR: Between sea level and the Kármán line, which has an altitude of 100 kilometers (62 miles).

LAND: On the surface of dry land.

SPACE: Above the Kármán line, which has an altitude of 100 kilometers (62 miles).

SURFACE: On the surface of a body of water.

SUBSURFACE: Below the surface of a body of water.

UNKNOWN: Environment is not known.

objTypestring

The type of object to which this record refers. The object type may be updated in later records based on assessment of additional data.

objTypeConfinteger

Confidence of the object type, 0-100.

objPlatstring

Space Platform field along with the Space Activity field further defines the identity of a Space track (examples: SATELLITE, WEAPON, PATROL). The object platform type. Intended as, but not constrained to, MIL-STD-6016 environment dependent platform type designations. The platform type can be reported as either a combination of the code and environment (e.g. 14/LAND) or as the descriptive representations (e.g. COMBAT VEHICLE), which are equivalent.

objIdent'ASSUMED FRIEND' | 'FRIEND' | 'HOSTILE' | 'NEUTRAL' | 'PENDING' | 'SUSPECT' | 'UNKNOWN'

The estimated identity of the track object (ASSUMED FRIEND, FRIEND, HOSTILE, NEUTRAL, PENDING, SUSPECT, UNKNOWN):

ASSUMED FRIEND: Track assumed to be a friend due to the object characteristics, behavior, and/or origin.

FRIEND: Track object supporting friendly forces and belonging to a declared friendly nation or entity.

HOSTILE: Track object belonging to an opposing nation, party, group, or entity deemed to contribute to a threat to friendly forces or their mission due to its behavior, characteristics, nationality, or origin.

NEUTRAL: Track object whose characteristics, behavior, nationality, and/or origin indicate that it is neither supporting nor opposing friendly forces or their mission.

PENDING: Track object which has not been evaluated.

SUSPECT: Track object deemed potentially hostile due to the object characteristics, behavior, nationality, and/or origin.

UNKNOWN: Track object which has been evaluated and does not meet criteria for any standard identity.

spaceAmpstring

Space amplification indicates additional information on the space environment being reported (examples: NUCLEAR WARHEAD, FUEL-AIR EXPLOSIVE WARHEAD, DEBRIS).

objActstring

Space activity (examples: RECONNAISSANCE, ANTISPACE WARFARE, TELEVISION). The activity in which the track object is engaged. Intended as, but not constrained to, MIL-STD-6016 environment dependent activity designations. The activity can be reported as either a combination of the code and environment (e.g. 65/AIR) or as the descriptive enumeration (e.g. DIVERTING), which are equivalent.

spaceSpecTypestring

Specific type of point or track with an environment of space.

acftSubTypestring

Subtype is a finer grain categorization of missile types. Examples include but are not limited to SRBM, MRBM, IRBM, LRBM, ICBM, SLBM.

SRBM - Short-Range Ballistic Missile

MRBM - Medium-Range Ballistic Missile

IRBM - Intermediate-Range Ballistic Missile

LRBM - Long-Range Ballistic Missile

ICBM - Intercontinental Ballistic Missile

SLBM - Submarine-Launched Ballistic Missile.

namestring

Track name.

callSignstring

The call sign currently assigned to the track object.

lostTrkIndboolean

Indicates whether or not the missile is considered lost.

trackIdstring

Track ID within the originating system.

parentTrackIdstring

Track ID of the parent track, within the originating system, from which the track was developed.

muidSrcTrkstring

Track ID for the source of the missile-unique identifier.

muidSrcstring

Source of the missile-unique identifier (MUID).

alertstring

A track may be designated as a non-alert track or an alert track.

Examples include but are not limited to:

Non-alert tracks - choose None (Blank).

Alert tracks - enter the proper alert classification:

HIT - High Interest Track

TGT - Target

SUS - Suspect Carrier

NSP - Cleared Suspect.

mslStatusstring

Missile status enumeration examples include but are not limited to:

AT LAUNCH

AT OBSERVATION

FLYING

IMPACTED

LOST

STALE

DEBRIS.

tsstring date-time required

The receipt time of the data by the processing system, in ISO8601 UTC format with microsecond precision.

aouRptTypestring

The Area of Uncertainty (AoU) type (BEARING, ELLIPSE, OTHER) definition. This type defines the elements of the aouEllp array and is required if aouEllp is not null. See the aouEllp field definition for specific information.

aouRptDatanumber[]

Three element array representing an Area of Uncertainty (AoU). The array element definitions and units are type specific depending on the aouType specified in this record:

  ELLIPSE:
    brg - orientation in degrees of the ellipse
    a1 - semi-major axis in kilometers
    a2 - semi-minor axis in kilometers

  BEARING (BEARING BOX or MTST BEARING BOX):
    brg - orientation in degrees of the bearing box
    a1 - length of bearing box in kilometers
    a2 - half-width of bearing box in kilometers

  OTHER (All other type values):
    brg - line of bearing in degrees true
    a1 - bearing error in degrees
    a2 - estimated range in kilometers.
containmentnumber double

The percentage of time that the estimated AoU will "cover" the true position of the track.

trkConfnumber double

Overall track confidence estimate (not standardized, but typically a value between 0 and 1, with 0 indicating lowest confidence).

trkQualinteger

Track Quality is reported as an integer from 0-15. Track Quality specifies the reliability of the positional information of a reported track, with higher values indicating higher track quality; i.e., lower errors in reported position.

angElevnumber double

Angle of elevation/depression between observer and missile in degrees.

senModestring

Last report type received from the sensor (for example, OBSBO = observation burnout).

infoSourcestring

Source code for source of information used to detect track.

boostingboolean

Indicates whether or not the missile is currently in a state of boosting.

polarSingLocLatnumber double

Azimuth corridor reference point latitude.

polarSingLocLonnumber double

Azimuth corridor reference point longitude.

emgIndboolean

Indicates whether or not a track has an emergency.

dropPtIndboolean

The drop-point indicator setting.

spaceAmpConfinteger

Confidence level of the amplifying characteristics. Values range from 0 to 6.

launchTimestring date-time

Missile launch timestamp in ISO8601 UTC format with microsecond precision.

launchLatnumber double

WGS-84 latitude of the missile launch point, in degrees. -90 to 90 degrees (negative values south of equator).

launchLonnumber double

WGS-84 longitude of the missile launch point, in degrees. -180 to 180 degrees (negative values west of Prime Meridian).

launchAltnumber double

Estimated launch point altitude relative to WGS-84 ellipsoid, in kilometers.

launchAznumber double

Angle between true north and the object's current position, with respect to the launch point, in degrees. 0 to 360 degrees.

launchAzUncnumber double

Uncertainty of the launch azimuth, in degrees.

launchConfnumber double

Confidence level in the accuracy of the launch point estimate. 0 - 100 percent.

azCorrnumber double

Missile azimuth corridor data.

burnoutAltnumber double

Track point burnout altitude relative to WGS-84 ellipsoid, in kilometers.

launchAouTypestring

The Area of Uncertainty (AoU) type (BEARING, ELLIPSE, OTHER) definition. This type defines the elements of the aouEllp array and is required if aouEllp is not null. See the aouEllp field definition for specific information.

launchAouDatanumber[]

Three element array representing an Area of Uncertainty (AoU). The array element definitions and units are type specific depending on the aouType specified in this record:

  ELLIPSE:
    brg - orientation in degrees of the ellipse
    a1 - semi-major axis in kilometers
    a2 - semi-minor axis in kilometers

  BEARING (BEARING BOX or MTST BEARING BOX):
    brg - orientation in degrees of the bearing box
    a1 - length of bearing box in kilometers
    a2 - half-width of bearing box in kilometers

  OTHER (All other type values):
    brg - line of bearing in degrees true
    a1 - bearing error in degrees
    a2 - estimated range in kilometers.
impactTimestring date-time

Estimated time of impact timestamp in ISO8601 UTC format with microsecond precision.

impactLatnumber double

WGS-84 latitude of the missile object impact point, in degrees. -90 to 90 degrees (negative values south of equator).

impactLonnumber double

WGS-84 longitude of the missile object impact point, in degrees. -180 to 180 degrees (negative values west of Prime Meridian).

impactAltnumber double

Estimated impact point altitude relative to WGS-84 ellipsoid, in kilometers.

impactAouTypestring

The Area of Uncertainty (AoU) type (BEARING, ELLIPSE, OTHER) definition. This type defines the elements of the aouEllp array and is required if aouEllp is not null. See the aouEllp field definition for specific information.

impactAouDatanumber[]

Three element array representing an Area of Uncertainty (AoU). The array element definitions and units are type specific depending on the aouType specified in this record:

  ELLIPSE:
    brg - orientation in degrees of the ellipse
    a1 - semi-major axis in kilometers
    a2 - semi-minor axis in kilometers

  BEARING (BEARING BOX or MTST BEARING BOX):
    brg - orientation in degrees of the bearing box
    a1 - length of bearing box in kilometers
    a2 - half-width of bearing box in kilometers

  OTHER (All other type values):
    brg - line of bearing in degrees true
    a1 - bearing error in degrees
    a2 - estimated range in kilometers.
impactConfnumber double

Confidence level of the impact point estimate. 0 - 100 percent.

maneuverStartstring date-time

Maneuver start time, in ISO 8601 UTC format with microsecond precision.

maneuverEndstring date-time

Maneuver end time, in ISO 8601 UTC format with microsecond precision.

contextKeysstring[]

An optional string array containing additional data (keys) representing relevant items for context of fields not specifically defined in this schema. This array is paired with the contextValues string array and must contain the same number of items. Please note these fields are intended for contextual use only and do not pertain to core schema information. To ensure proper integration and avoid misuse, coordination of how these fields are populated and consumed is required during onboarding.

contextValuesstring[]

An optional string array containing the values associated with the contextKeys array. This array is paired with the contextKeys string array and must contain the same number of items. Please note these fields are intended for contextual use only and do not pertain to core schema information. To ensure proper integration and avoid misuse, coordination of how these fields are populated and consumed is required during onboarding.

origNetworkstring

The originating source network on which this record was created, auto-populated by the system.

createdAtstring date-time

Time the row was created in the database.

createdBystring

Application user who created the row in the database.

sourcestring required

Source of the data.

originstring

Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.

dataMode'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE' required

Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data:

REAL: Data collected or produced that pertains to real-world objects, events, and analysis.

TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics.

EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data.

SIMULATED: Synthetic data generated by a model to mimic real-world datasets.

Example request

[
  {
    "id": "MissileTrack_ID",
    "classificationMarking": "U",
    "msgType": "MSG-TYPE",
    "msgSubType": "Update",
    "msgCreateDate": "2024-04-25T08:17:01.346Z",
    "env": "AIR",
    "objType": "Ballistic",
    "objTypeConf": 90,
    "objPlat": "WEAPON",
    "objIdent": "FRIEND",
    "spaceAmp": "NUCLEAR WARHEAD",
    "objAct": "HOLDING",
    "spaceSpecType": "SS-21_MOD_2_CRBM",
    "acftSubType": "SLBM",
    "name": "TRACK-NAME",
    "callSign": "Charlie",
    "trackId": "102288",
    "parentTrackId": "102288",
    "muidSrcTrk": "MUID-SRC-ID",
    "muidSrc": "MUID-SRC",
    "alert": "HIT",
    "mslStatus": "AT LAUNCH",
    "ts": "2021-02-25T12:00:00.123456Z",
    "aouRptType": "ELLIPSE",
    "aouRptData": [
      34.3,
      26.5,
      1.2
    ],
    "containment": 90.64,
    "trkConf": 0.95,
    "trkQual": 1,
    "angElev": 15.2,
    "senMode": "OBSBO",
    "infoSource": "S1",
    "boosting": true,
    "polarSingLocLat": 19.88550102,
    "polarSingLocLon": 46.74596844,
    "emgInd": true,
    "dropPtInd": true,
    "spaceAmpConf": 6,
    "launchTime": "2021-02-25T12:00:00.123456Z",
    "launchLat": 19.88550102,
    "launchLon": 46.74596844,
    "launchAlt": 0.01,
    "launchAz": 99.1,
    "launchAzUnc": 2.4,
    "launchConf": 90.7,
    "azCorr": 12.876,
    "burnoutAlt": 30567.452,
    "launchAouType": "ELLIPSE",
    "launchAouData": [
      1.23,
      2.34,
      3.45
    ],
    "impactTime": "2021-02-25T12:00:00.123456Z",
    "impactLat": 19.88550102,
    "impactLon": 46.74596844,
    "impactAlt": 0.02,
    "impactAouType": "ELLIPSE",
    "impactAouData": [
      34.3,
      26.5,
      1.2
    ],
    "impactConf": 99.9,
    "maneuverStart": "2021-01-01T01:01:01.123456Z",
    "maneuverEnd": "2021-01-01T01:01:15.456789Z",
    "contextKeys": [
      "MsnID_DescLabel",
      "msnVer",
      "serVer",
      "velTs",
      "accelTs"
    ],
    "contextValues": [
      "MissionID Descriptive Label text",
      "1",
      "001.9b",
      "2024-06-07T14:17:39.234Z",
      "2024-06-07T14:17:39.123Z"
    ],
    "vectors": [
      {
        "type": "STATE",
        "object": "TARGET",
        "epoch": "2024-03-30T15:02:39.346768Z",
        "idSensor": "a7e99418-b6d6-29ab-e767-440a989cce26",
        "origSensorId": "ORIGSENSOR-ID",
        "pos": [
          -1456.91592,
          -2883.54041,
          6165.55186
        ],
        "vel": [
          -1.21981,
          -6.60208,
          -3.36515
        ],
        "accel": [
          0.59236,
          -0.03537,
          0.35675
        ],
        "course": 7.3580153,
        "spd": 15.03443,
        "referenceFrame": "ECEF",
        "cov": [
          1.1,
          2.2,
          3.3
        ],
        "covReferenceFrame": "ECR/ECEF",
        "vectorLat": 45,
        "vectorLon": 150,
        "vectorAlt": 25,
        "confidence": 100,
        "status": "INITIAL",
        "vectorTrackId": "102288",
        "timeSource": "Sensor1",
        "quat": [
          0.03,
          0.02,
          0.01,
          0.012
        ],
        "flightAz": 45.23,
        "range": 12.3,
        "contextKeys": [
          "MsnID_DescLabel",
          "msnVer",
          "serVer",
          "velTs",
          "accelTs"
        ],
        "contextValues": [
          "MissionID Descriptive Label text",
          "1",
          "001.9b",
          "2024-06-07T14:17:39.234Z",
          "2024-06-07T14:17:39.123Z"
        ]
      }
    ],
    "origNetwork": "OPS1",
    "createdAt": "2021-02-25T12:00:00.123Z",
    "createdBy": "some.user",
    "source": "Bluestaq",
    "origin": "THIRD_PARTY_DATASOURCE",
    "dataMode": "TEST"
  }
]

Response

Accepted

Changes

  • bd17bc53681eRevision changes
    • info

      added the non-success response with the status

  • 09bd422d5ac1Revision changes
    • breaking

      removed the enum value ECEF of the request property ///

    • info

      added the new ECR/ECEF enum value to the request property ///

Some revisions have not been checked yet.