NVnvidia
tracker

Get tracked objects

Retrieve objects tracked across one or more sensors, including their constituent behaviors or tracklets, for a specified time range and optional filters.

get/tracker/unique-objects

Request

Query parameters

fromTimestampstring date-time required
toTimestampstring date-time required
sensorIdsstring[]

This parameter is incompatible with place. Only one of them can exist in the query. When objectId is present, then only one sensorId can be present in the sensorIds array.

objectIdstring
placestring

This parameter is incompatible with sensorIds and globalId. Only one of them can exist in the query.

globalIdstring

This parameter is incompatible with sensorIds and place. Only one of them can exist in the query.

maxResultSizeinteger

This parameter is incompatible with globalId. Only one of them can exist in the query.

Response

Successful Operation.

Example response

{
  "uniqueObjects": [
    {
      "batchId": "batch-1",
      "globalId": "1",
      "timestamp": "2022-08-25T00:00:00.000Z",
      "end": "2022-08-25T00:00:55.000Z",
      "objectType": "Person",
      "matched": [
        {
          "id": "Cam1 #-# 11",
          "sensorId": "Cam1",
          "objectId": "11",
          "objectType": "Person",
          "timestamp": "2022-08-25T00:00:00.000Z",
          "end": "2022-08-25T00:00:30.000Z",
          "startFrame": "10",
          "endFrame": "910",
          "place": "city=Santa Clara/building=K",
          "locations": [
            [
              10,
              11
            ]
          ]
        },
        {
          "id": "Cam2 #-# 12",
          "sensorId": "Cam2",
          "objectId": "12",
          "objectType": "Person",
          "timestamp": "2022-08-25T00:00:40.000Z",
          "end": "2022-08-25T00:00:55.000Z",
          "startFrame": "210",
          "endFrame": "1010",
          "place": "city=Santa Clara/building=K",
          "locations": [
            [
              10,
              11
            ]
          ]
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 9 revisions of this API.