Skip to main content

Object Track

This schema builds on the following shared schemas:

PropertyTypeRequiredNote
channel_idIntegerYesUniquely identifies a source within a single device, for example, a video or radar sensor
classesArray of ObjectClassNoClassification candidates for the track (e.g., person, vehicle)
durationFloatNoTotal duration of the track in seconds. - Normally equals end_time - start_time but calculated using a monotonic clock
end_timeStringNoTimestamp of the last observation in the track
idIDYesGlobally unique identifier
imageSnapshotNoRepresentative snapshot of the tracked object
maximum_speedFloatNoMaximum measured speed of an object in m/s
minimum_speedFloatNoMinimum measured speed of an object in m/s
partsArray of ObjectTrackReferenceNoReferences to the original object tracks that were combined to create this track.

Each entry represents another ObjectTrack. The content of this track contains the
combined content of its parts, with the same or less detail.

This field records when ObjectTracks are transformed or combined, for example as a
result of a rename or similar operation. For pure transformations of a track, such
as switching coordinate systems or simplifying the content, this field contains only
one entry referencing the original track
pathArray of TimeAndPositionNoTime-ordered samples of the track’s trajectory (timestamps and positions)
start_timeStringNoTimestamp of the first observation in the track

Object Track Reference

PropertyTypeRequiredNote
object_track_idIDNoGlobally unique identifier
partsArray of ObjectTrackReferenceNoReferences to the original object tracks that were combined to create this track.

Each entry represents another ObjectTrack. The content of this track contains the
combined content of its parts, with the same or less detail.

This field records when ObjectTracks are transformed or combined, for example as a
result of a rename or similar operation. For pure transformations of a track, such
as switching coordinate systems or simplifying the content, this field contains only
one entry referencing the original track

Snapshot

Cropped image

PropertyTypeRequiredNote
crop_boxBoundingBoxYesNormalized bounding box of the region captured in data, relative to the source image.
dataStringYesImage payload. Base64 encoded when serialized to json
idStringYesUUID identifier string for the snapshot
timestampStringYesAccording to format: YYYY-MM-DDTHH:MM:SS.MMMMMMZ