Skip to content
Worlds API Docs

track

Query

Look up a track, a record of the motion of a detected object, by its unique identifier.

Response

Returns Track

Arguments

NameTypeDescription
idID!

The track’s unique identifier.

timestampDateTimeOffset

If provided, locate the track within 24 hours of the given time. Otherwise, the track will only be identified if it is less than 24 hours since it was active.

Example

query track(
  $id: ID!,
  $timestamp: DateTimeOffset
) {
  track(
    id: $id,
    timestamp: $timestamp
  ) {
    id
    dataSource {
      id
      name
      type
      device {
        id
        uuid
        externalId
        name
        enabled
        address
        frameRate
        transcoderId
        lastHeartbeat
      }
      zones {
        id
        name
        active
        createdAt
        updatedAt
      }
      labels
    }
    video {
      id
      dataSource {
        id
        name
        type
        labels
      }
      startTime
      endTime
      cloudAvailable
      sync {
        state
        segmentsDone
        segmentsTotal
        attempts
        lastEventAt
        error
      }
      url
      thumbnailUrl
      displayName
      resolutionHeight
      resolutionWidth
      frameRate
      createdBy {
        id
        emailAddress
      }
    }
    modelId
    tag
    startTime
    endTime
    finished
    detections {
      id
      track {
        id
        modelId
        tag
        startTime
        endTime
        finished
        metadata
      }
      timestamp
      frame {
        number
      }
      polygon {
        type
        coordinates
      }
      position {
        type
        coordinates
      }
      zones {
        id
        name
        active
        createdAt
        updatedAt
      }
      geofences {
        id
        name
        labels
        active
      }
      metadata
      createdAt
      updatedAt
      direction
    }
    properties {
      identifier {
        type
        value
      }
      attributes {
        type
        value
      }
    }
    metadata
    zoneIntersections {
      id
      zone {
        id
        name
        active
        createdAt
        updatedAt
      }
      track {
        id
        modelId
        tag
        startTime
        endTime
        finished
        metadata
      }
      startTime
      endTime
    }
    geofenceIntersections {
      id
      geofence {
        id
        name
        labels
        active
      }
      track {
        id
        modelId
        tag
        startTime
        endTime
        finished
        metadata
      }
      startTime
      endTime
    }
  }
}