BLbluestaq
AirOperations

POST /udl/trackroute

Changed on

Service operation to take a single trackroute record as a POST body and ingest into the database. 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/udl/trackroute
  • Auth
    none declared

Request body

idstring

Unique identifier of the record, auto-generated by the system.

classificationMarkingstring required

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

typestring required

The track route type represented by this record (ex. AIR REFUELING).

externalIdstring

Optional air refueling track ID from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID.

directionstring

The principal compass direction (cardinal or ordinal) of the track route.

creatingOrgstring

The name of the creating organization of the track route.

locationTrackIdstring

Track location ID.

trackIdstring

Identifier of the track.

trackNamestring

Name of the track.

shortNamestring

Abbreviated name of the track.

typeCodestring

Type of process used by AMC to schedule an air refueling event. Possible values are A (Matched Long Range), F (Matched AMC Short Notice), N (Unmatched Theater Operation Short Notice (Theater Assets)), R, Unmatched Long Range, S (Soft Air Refueling), T (Matched Theater Operation Short Notice (Theater Assets)), V (Unmatched AMC Short Notice), X (Unmatched Theater Operation Short Notice (AMC Assets)), Y (Matched Theater Operation Short Notice (AMC Assets)), Z (Other Air Refueling).

regionCodestring

Region code indicating where the track resides as determined by the data source.

regionNamestring

Region where the track resides.

apxBeaconCodestring

The APX radar code sent and received by the aircraft for identification.

receiverTankerCHCodestring

The receiver tanker channel identifer for air refueling tracks.

apnSettingstring

The APN radar code sent and received by the aircraft for identification.

sicstring

Standard Indicator Code of the air refueling track.

reviewDatestring date-time

Date the track needs to be reviewed for accuracy or deletion in ISO 8601 UTC format with millisecond precision.

lastUsedDatestring date-time

Used to show last time the track route was added to an itinerary in ISO 8601 UTC format with millisecond precision.

lastUpdateDatestring date-time required

The last updated date of the track route in ISO 8601 UTC format with millisecond precision.

priFreqnumber double

The primary UHF radio frequency used for the track route in megahertz.

secFreqnumber double

The secondary UHF radio frequency used for the track route in megahertz.

artccMessagestring

Air Refueling Track Control Center message.

schedulerOrgNamestring

Point of contact for the air refueling track route scheduler.

schedulerOrgUnitstring

The unit responsible for scheduling the track route.

effectiveDatestring date-time

The date which the DAFIF track was last updated/validated in ISO 8601 UTC format with millisecond precision.

createdAtstring date-time

Time the row was created in the database, auto-populated by the system.

createdBystring

Application user who created the row in the database, auto-populated by the system.

updatedAtstring date-time

Time the row was updated in the database, auto-populated by the system.

updatedBystring

Application user who updated the row in the database, auto-populated by the system.

sourceDLstring

The source data library from which this record was received. This could be a remote or tactical UDL or another data library. If null, the record should be assumed to have originated from the primary Enterprise UDL.

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.

origNetworkstring

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

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": "026dd511-8ba5-47d3-9909-836149f87686",
  "classificationMarking": "U",
  "type": "AIR REFUELING",
  "externalId": "GDSSMH121004232315303094",
  "direction": "NE",
  "creatingOrg": "HQPAC",
  "locationTrackId": "POACHR",
  "trackId": "CH61A",
  "trackName": "CH61 POST",
  "shortName": "CH61",
  "typeCode": "V",
  "regionCode": "5",
  "regionName": "North America",
  "apxBeaconCode": "5/1",
  "receiverTankerCHCode": "31/094",
  "apnSetting": "1-3-1",
  "sic": "N",
  "reviewDate": "2024-09-16T16:00:00.123Z",
  "lastUsedDate": "2024-09-17T16:00:00.123Z",
  "lastUpdateDate": "2024-09-17T16:00:00.123Z",
  "priFreq": 357.5,
  "secFreq": 319.7,
  "artccMessage": "OAKLAND CTR/GUAM CERAP",
  "schedulerOrgName": "97 OSS/OSOS DSN 866-5555",
  "schedulerOrgUnit": "612 AOC",
  "effectiveDate": "2024-09-17T16:00:00.123Z",
  "routePoints": [
    {
      "ptSequenceId": 1,
      "ptTypeCode": "EP",
      "ptTypeName": "ENTRY POINT",
      "waypointName": "KCHS",
      "dafifPt": true,
      "ptLat": 45.23,
      "ptLon": 179.1,
      "magDec": 7.35,
      "navaidLength": 100.2,
      "navaid": "HTO",
      "countryCode": "NL",
      "altCountryCode": "IZ",
      "navaidType": "VORTAC"
    }
  ],
  "altitudeBlocks": [
    {
      "altitudeSequenceId": "A1",
      "lowerAltitude": 27000.1,
      "upperAltitude": 27200.5
    }
  ],
  "poc": [
    {
      "pocSequenceId": 1,
      "pocTypeName": "Originator",
      "pocName": "Fred Smith",
      "office": "A34",
      "username": "fgsmith",
      "rank": "Capt",
      "pocOrg": "HQAF",
      "phone": "8675309",
      "remark": "POC remark."
    }
  ],
  "createdAt": "2022-01-01T16:00:00.123Z",
  "createdBy": "some.user",
  "updatedAt": "2022-01-01T16:00:00.123Z",
  "updatedBy": "some.user",
  "sourceDL": "AXE",
  "source": "Bluestaq",
  "origin": "THIRD_PARTY_DATASOURCE",
  "origNetwork": "OPS1",
  "dataMode": "TEST"
}

Response

Success

Changes

  • 45631f9bb3f0Revision changes
    • breaking

      the request property's minLength was increased from 0 to 1

  • 75f764c843a9Revision changes
    • info

      api operation id create_132 removed and replaced with

    • info

      the endpoint scheme security BasicAuth was removed from the API

Some revisions have not been checked yet.