Skip to content

Detection

About detections

Detections are the lowest level unit of computer vision primitive within Worlds. A detection represents a single frame of a recognized object, which then has additional data associated with it, including its position, track, and interactions with zones and geofences.

globalTrackId

The global track id that governs the detection, if any.

Type: String

deviceId

The unique identifier of the device where the detection occurred.

Type: ID

tag

The class label of the detected object, i.e person, car, truck, etc.

Type: String!

frame

Information about the video frame in which this detection was captured

Type: Frame

timestamp

The time at which the detection occurred.

Type: DateTimeOffset!

polygon

A GeoJSON polygon that represents the spatial bounds of the detection.

Type: GeoJSONPolygon

position

A GeoJSON point that represents the location of the detection in the world. This value may be null if the camera that captured the detection hasn’t been calibrated. It may also be null if the location cannot be calculated (i.e the detected object is in the sky).

Type: GeoJSONPoint

track

The track that is associated with the detection.

Type: Track!

zones

A list of Zones with which the detection intersects.

Type: [Zone!]!

geofences

A list of Geofences with which the detection intersects.

Type: [Geofence!]!

zoneIds

A list of zone unique identifiers with which the detection intersects.

Type: [ID!]!

geofenceIds

A list of geofence unique identifiers with which the detection intersects.

Type: [ID!]!

zoneEvents

A list of zone events related to this detection.

Type: [ZoneEvent!]!

geofenceEvents

A list of geofence events related to this detection.

Type: [GeofenceEvent!]!

metadata

Arbitrary metadata associated with the detection.

Type: JSON

createdAt

Timestamp that the detection was created. May be delayed from the timestamp due to post-processing video feeds or other latency.

Type: DateTimeOffset

updatedAt

Timestamp that the detection was most recently updated.

Type: DateTimeOffset

direction

The direction in which the detection is moving, represented in degrees.

Type: Float