--- title: "GET /udl/featureassessment/{id}" method: GET path: "/udl/featureassessment/{id}" tags: ["Report and Activity"] --- # GET /udl/featureassessment/{id} `GET /udl/featureassessment/{id}` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/featureassessment/{id}` - Auth: none declared Service operation to get a single FeatureAssessment record by its unique ID passed as a path parameter. ## Path parameters - `id` string, required ## Query parameters - `firstResult` integer - `maxResults` integer ## Response `200` OK - FeatureAssessmentFull: Feature assessments obtained from imagery analysis or other data analytics. Feature assessments are georeferenced terrestrial features such as marine vessels, vehicles, buildings, etc., or contain other types of non terrestrial assessments such as spacecraft structures. Geospatial queries are supported through either the regionText (WKT) or regionGeoJSON fields. - `id` string: Unique identifier of the record, auto-generated by the system. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `featureTs` string, date-time, required: Datetime type value associated with this record, in ISO 8601 UTC format with millisecond precision. - `idAnalyticImagery` string, required: Unique identifier of the Analytic Imagery associated with this Feature Assessment record. - `type` string: The type of feature (e.g. AIRCRAFT, ANTENNA, SOLAR ARRAY, SITE, STRUCTURE, VESSEL, VEHICLE, UNKNOWN, etc.) detailed in this feature assessment record. This type may be a primary feature within an image, for example a VESSEL, or may be a component or characteristic of a primary feature, for example an ANTENNA mounted on a vessel. - `externalId` string: Feature Assessment 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. - `name` string: Source defined name of the feature associated with this record. If an annotation for this feature element exists on the parent image it can be referenced here. - `length` number, double: Estimated physical length of the feature, in meters. - `width` number, double: Estimated physical width of the feature, in meters. - `height` number, double: Estimated physical height of the feature, in meters. - `heading` number, double: The feature object heading, in degrees clockwise from true North at the object location. - `speed` number, double: Feature's speed of travel, in meters per second. - `featureUoM` string, required: The Unit of Measure associated with this feature. If there are no physical units associated with the feature a value of NONE should be specified. - `featureValue` number, double: A single feature/assessment value expressed in the specified unit of measure (featureUoM). Because of the variability of the Feature Assessment data types, each record may employ a numeric observation value (featureValue), a string observation value (featureString), a Boolean observation value (featureBool), an array of numeric observation values (featureArray), or any combination of these. - `featureString` string: A single feature/assessment string expressed in the specified unit of measure (featureUoM). Because of the variability of the Feature Assessment data types, each record may employ a numeric observation value (featureValue), a string observation value (featureString), a Boolean observation value (featureBool), an array of numeric observation values (featureArray), or any combination of these. - `featureArray` number[]: An array of numeric feature/assessment values expressed in the specified unit of measure (featureUoM). Because of the variability of the Feature Assessment data types, each record may employ a numeric observation value (featureValue), a string observation value (featureString), a Boolean observation value (featureBool), an array of numeric observation values (featureArray), or any combination of these. - `featureStringArray` string[]: An array of string feature/assessment expressions. Because of the variability of the Feature Assessment data types, each record may employ a numeric observation value (featureValue), a string observation value (featureString), a Boolean observation value (featureBool), an array of numeric observation values (featureArray), or any combination of these. - `featureBool` boolean: A boolean feature/assessment. Because of the variability of the Feature Assessment data types, each record may employ a numeric observation value (featureValue), a string observation value (featureString), a Boolean observation value (featureBool), an array of numeric observation values (featureArray), or any combination of these. - `assessment` string: Descriptive or additional information associated with this feature/assessment. - `confidence` number, double: Analytic confidence of feature accuracy (0 to 1). - `area` string: Optional geographical region or polygon (lat/lon pairs) of the area surrounding the feature assessment as projected on the ground. - `atext` string: Geographical region or polygon (lon/lat pairs), as depicted by the Well-Known Text representation of the geometry/geography, of the feature assessment as projected on the ground. WKT reference: https://www.opengeospatial.org/standards/wkt-crs. Ignored if included with a POST or PUT request that also specifies a valid 'area' field. - `agjson` string: Geographical region or polygon (lat/lon pairs), as depicted by the GeoJSON representation of the geometry/geography, of the feature assessment as projected on the ground. GeoJSON Reference: https://geojson.org/. Ignored if included with a POST or PUT request that also specifies a valid 'area' or 'atext' field. - `atype` string: Type of region as projected on the ground (POLYGON, POINT, LINE). - `andims` integer: Number of dimensions of the geometry depicted by region. - `asrid` integer: Geographical spatial_ref_sys for region. - `annLims` array[]: Polygonal annotation limits, specified in pixels, as an array of arrays N x M. Allows the image provider to highlight one or more polygonal area(s) of interest. The array must contain NxM two-element arrays, where N is the number of polygons of interest. The associated annotation(s) should be included in the annText array. - integer[] - `annText` string[]: Annotation text, a string array of annotation(s) corresponding to the rectangular areas specified in annLims. This array contains the annotation text associated with the areas of interest indicated in annLims, in order. This array should contain one annotation per four values of the area (annLims) array. - `srcTyps` string[]: Array of UDL record types (AIS, GROUNDIMAGE, MTI, ONORBIT, POI, SAR, SKYIMAGE, SOI, TRACK) related to this feature assessment. See the associated 'srcIds' and 'srcTs' arrays for the record UUIDs and timetsmps. respectively, positionally corresponding to the record types in this array. The 'srcTyps', 'srcIds', and 'srcTs' arrays must contain the same number of elements. - `srcIds` string[]: Array of UUIDs of the UDL data records that are related to the determination of this activity or event. See the associated 'srcTyps' array for the specific types of data, positionally corresponding to the UUIDs in this array. The 'srcTyps', 'srcIds', and 'srcTs' arrays must contain the same number of elements. See the corresponding srcTyps array element for the data type of the UUID and use the appropriate API operation to retrieve that object. - `srcTs` string[]: Array of the primary timestamps, in ISO 8601 UTC format, with appropriate precision for the datatype of each correspondng srcTyp/srcId record. See the associated 'srcTyps' and 'srcIds' arrays for the record type and UUID, respectively, positionally corresponding to the record types in this array. The 'srcTyps', 'srcIds', and 'srcTs' arrays must contain the same number of elements. These timestamps are included to support services which do not include a GET by {id} operation. If referencing a datatype which does not include a primary timestamp, the corresponding srcTs array element should be included as null. - `tags` string[]: 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. - `transactionId` string: Optional identifier to track a commercial or marketplace transaction executed to produce this data. - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system. - `createdBy` string: Application user who created the row in the database, auto-populated by the system. - `sourceDL` string: 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. - `source` string, required: Source of the data. - `origin` string: 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. - `origNetwork` string: 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. ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `404`: Item Not Found - `405`: Method Not Allowed - `406`: MediaType Not Accepted by Request Headers - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2025-09-26** `45631f9bb3f0`: 1 info - the response optional property `area` became write-only for the status `200` - **2025-05-29** `4e1cbc17e814`: 2 info - added the new optional `query` request parameter `firstResult` - added the new optional `query` request parameter `maxResults` - **2025-04-16** `75f764c843a9`: 1 info - endpoint added [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/featureassessment/:id/get.md) --- [API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)