searchTrackImages

Query

Search for tracks whose images match a text description.

Response

Returns SearchTrackImagesResponse

Arguments

Name	Type	Description
`searchText`	`String!`	The text description to search against.
`searchImage`	`Boolean!`	If true, the searchText will refer to the entire image, rather than just the track. Defaults to false. Default: `false`
`collectionId`	`ID`	If provided, only search for tracks from the given collection.
`pointOfInterestId`	`ID`	If provided, only search for tracks from the given point of interest.
`dataSourceIds`	`[ID!]`	If provided, only search for tracks from the given data source.
`startTime`	`DateTimeOffset`	If provided, only search for tracks after the given start time.
`endTime`	`DateTimeOffset`	If provided, only search for tracks before the given end time.
`includeTagIds`	`[ID!]`	If provided, only search for tracks from matching one of the given tags.
`excludeTagIds`	`[ID!]`	If provided, do not return tracks matching the given tags.
`first`	`Int!`	Returns the first n entries from the search. Default: `20`

Example

query searchTrackImages(
  $searchText: String!,
  $searchImage: Boolean!,
  $collectionId: ID,
  $pointOfInterestId: ID,
  $dataSourceIds: [ID!],
  $startTime: DateTimeOffset,
  $endTime: DateTimeOffset,
  $includeTagIds: [ID!],
  $excludeTagIds: [ID!],
  $first: Int!
) {
  searchTrackImages(
    searchText: $searchText,
    searchImage: $searchImage,
    collectionId: $collectionId,
    pointOfInterestId: $pointOfInterestId,
    dataSourceIds: $dataSourceIds,
    startTime: $startTime,
    endTime: $endTime,
    includeTagIds: $includeTagIds,
    excludeTagIds: $excludeTagIds,
    first: $first
  ) {
    tracks {
      track {
        id
        modelId
        tag
        startTime
        endTime
        finished
        metadata
      }
      dataSource {
        id
        name
        type
        labels
      }
      trackBoxId
      timestamp
      confidence
    }
  }
}

{
  "searchText": "searchText-84f3",
  "searchImage": false,
  "first": 20
}

{
  "data": {
    "searchTrackImages": {
      "tracks": [
        {
          "track": {
            "id": "58b9a930-5ec7-8c7d-8931-530b08e58c11",
            "modelId": "f3b1dcb1-ac50-8fce-8509-3e824b58448b",
            "tag": "tag-70cb",
            "startTime": "2025-01-01T00:00:00.000Z",
            "endTime": "2025-01-01T00:00:00.000Z",
            "finished": false,
            "metadata": {}
          },
          "dataSource": {
            "id": "d12da500-1c9d-8517-8064-a811ebcd3707",
            "name": "name-549e",
            "type": "FOLDER",
            "labels": [
              "labels-516b"
            ]
          },
          "trackBoxId": "1f77007b-d479-89a9-9b50-2ca9001a522b",
          "timestamp": "2025-01-01T00:00:00.000Z",
          "confidence": 69.92
        }
      ]
    }
  }
}