BLbluestaq
Sky Imagery

GET /udl/skyimagery

Changed on

Service operation to dynamically query data by a variety of query parameters not specified in this API documentation. See the queryhelp operation (/udl/<datatype>/queryhelp) for more details on valid/required query parameter information.

Request

  • Base URL
    https://unifieddatalibrary.com
  • URL
    https://unifieddatalibrary.com/udl/skyimagery
  • Auth
    none declared

Query parameters

expStartTimestring date-time required

Start time of the exposure, in ISO 8601 UTC format with microsecond precision. (YYYY-MM-DDTHH:MM:SS.ssssssZ)

firstResultinteger
maxResultsinteger

Response

OK

idstring

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

classificationMarkingstring required

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

idOnOrbitstring

Optional identifier of the target on-orbit object, if correlated.

origObjectIdstring

Optional identifier provided by the imaging source to indicate the target onorbit object of this image. This may be an internal identifier and not necessarily a valid satellite number.

idSOISetstring

Optional unique identifier of the SOI Observation Set associated with this image.

idAttitudeSetstring

Optional identifier of the AttitudeSet data record describing the orientation of an object body.

idSensorstring

Unique identifier of the reporting sensor.

satNointeger

Catalog number of the target on-orbit object.

origSensorIdstring

Optional identifier provided by the imaging source to indicate the sensor identifier which produced this image. This may be an internal identifier and not necessarily a valid sensor ID.

senlatnumber double

Sensor latitude at exposure start epoch, in degrees. If null, can be obtained from sensor info. -90 to 90 degrees (negative values south of equator).

senlonnumber double

Sensor longitude at exposure start epoch, in degrees. If null, can be obtained from sensor info. -180 to 180 degrees (negative values west of Prime Meridian).

senaltnumber double

Sensor altitude at exposure start epoch, in km. If null, can be obtained from sensor info.

senxnumber double

Sensor x position at exposure start epoch, in km (if mobile/onorbit) in J2000 coordinate frame.

senynumber double

Sensor y position at exposure start epoch, in km (if mobile/onorbit) in J2000 coordinate frame.

senznumber double

Sensor z position at exposure start epoch, in km (if mobile/onorbit) in J2000 coordinate frame.

senQuatnumber[]

The quaternion describing the rotation of the body-fixed frame used for this system into the local geodetic frame, at exposure start epoch (expStartTime). The array element order convention is scalar component first, followed by the three vector components. For a vector u in the body-fixed frame, the corresponding vector u' in the geodetic frame should satisfy u' = quq*, where q is this quaternion.

senQuatDotnumber[]

The derivative of the quaternion describing the rotation of the body-fixed frame used for this system into the local geodetic frame, exposure start epoch (expStartTime). The array element order convention is scalar component first, followed by the three vector components. For a vector u in the body-fixed frame, the corresponding vector u' in the geodetic frame should satisfy u' = quq*, where q is this quaternion.

imageTypestring required

The type of image associated with this record (e.g. FITS, EOSSA, EOCHIP, MP4).

expStartTimestring date-time required

Start time of the exposure, in ISO 8601 UTC format with microsecond precision.

expEndTimestring date-time

End time of the exposure, in ISO 8601 UTC format with microsecond precision.

imageSourceInfostring

String that uniquely identifies the data source.

topLeftStartAznumber double

The telescope pointing azimuth, in degrees, at the exposure start epoch.

topLeftStartElnumber double

The telescope pointing elevation, in degrees, at the exposure start epoch.

topLeftStopAznumber double

The telescope pointing azimuth, in degrees, at the exposure stop epoch.

topLeftStopElnumber double

The telescope pointing elevation, in degrees, at the exposure stop epoch.

imageSetIdstring

The user-defined set ID of a sequence of images.

imageSetLengthinteger

The number of images in an image set.

sequenceIdinteger

The sequence ID of an image within an image set.

frameFOVWidthnumber double

Field Of View frame width, in degrees.

frameFOVHeightnumber double

Field Of View frame height, in degrees.

pixelFOVWidthnumber double

Field Of View pixel width, in degrees.

pixelFOVHeightnumber double

Field Of View pixel height, in degrees.

frameWidthPixelsinteger

Frame width of the image, in number of pixels.

frameHeightPixelsinteger

Frame height of the image, in number of pixels.

pixelBitDepthinteger

Bit depth of the image, in number of pixels.

annotationKeystring

Reference to an annotation document associated with this image.

calibrationKeystring

Reference to a calibration document associated with this image.

filenamestring

Name of the uploaded image file.

filesizeinteger

Size of the image file, in bytes.

checksumValuestring

MD5 value of the file. The ingest/create operation will automatically generate the value.

transactionIdstring

Optional identifier to track a commercial or marketplace transaction executed to produce this data.

tagsstring[]

Optional array of provider/source specific tags for this data, where each element is no longer than 32 characters, used for implementing data owner conditional access controls to restrict access to the data. Should be left null by data providers unless conditional access controls are coordinated with the UDL team.

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.

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.

descriptionstring

Optional name/description associated with this image.

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.

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.

Example response

[
  {
    "id": "SKYIMAGERY-ID",
    "classificationMarking": "U",
    "idOnOrbit": "44920",
    "origObjectId": "X15-23452",
    "idSOISet": "531093d0-e9b0-475b-687aeeefefd9",
    "idAttitudeSet": "d039ba29-52f4-4839-8a8f-e85fa416aec5",
    "idSensor": "420",
    "satNo": 25544,
    "origSensorId": "origSensorId",
    "senlat": -33.283048,
    "senlon": 149.372549,
    "senalt": 14.483619321,
    "senx": 14.52,
    "seny": 32.41,
    "senz": 376.12,
    "senQuat": [
      0.03,
      0.02,
      0.01,
      0.012
    ],
    "senQuatDot": [
      0.03,
      0.02,
      0.01,
      0.012
    ],
    "imageType": "imageType",
    "expStartTime": "2021-01-01T01:01:01.123456Z",
    "expEndTime": "2021-01-01T01:01:01.123456Z",
    "imageSourceInfo": "imageSourceInfo",
    "topLeftStartAz": 146.321,
    "topLeftStartEl": 146.321,
    "topLeftStopAz": 3.7,
    "topLeftStopEl": 34.233,
    "imageSetId": "imageSetId",
    "imageSetLength": 9,
    "sequenceId": 1,
    "frameFOVWidth": 21.23,
    "frameFOVHeight": 21.23,
    "pixelFOVWidth": 321.123,
    "pixelFOVHeight": 321.123,
    "frameWidthPixels": 1,
    "frameHeightPixels": 1,
    "pixelBitDepth": 1,
    "annotationKey": "annotationKey",
    "calibrationKey": "calibrationKey",
    "filename": "filename.jpg",
    "filesize": 371945,
    "checksumValue": "checksumValue",
    "transactionId": "a7bdef1f-5a4f-4716-bee4-7a1e0ec7d35a",
    "tags": [
      "PROVIDER_TAG1",
      "PROVIDER_TAG2"
    ],
    "source": "Bluestaq",
    "origin": "THIRD_PARTY_DATASOURCE",
    "origNetwork": "OPS1",
    "sourceDL": "AXE",
    "description": "description",
    "dataMode": "TEST",
    "createdAt": "2018-01-01T16:00:00.123Z",
    "createdBy": "some.user"
  }
]

Changes

  • 173e4aff893fRevision changes
    • breaking

      the / response property's minItems was decreased from 4 to 0 for the response status

    • breaking

      the / response property's minItems was decreased from 4 to 0 for the response status

  • 4e1cbc17e814Revision changes
    • info

      added the new optional query request parameter firstResult

    • info

      added the new optional query request parameter maxResults

Some revisions have not been checked yet.