Get tracked objects

GET

https://ai.nvidia.com/api/v3.3/analytics/tracker/unique-objects

GET

/api/v3.3/analytics/tracker/unique-objects

curl -G https://ai.nvidia.com/api/v3.3/analytics/tracker/unique-objects \
     --data-urlencode fromTimestamp=2022-08-25T00:00:00.000Z \
     -d globalId=1 \
     -d maxResultSize=10 \
     -d objectId=101 \
     -d place=city \
     -d sensorIds=Cam1 \
     -d sensorIds=Cam2 \
     --data-urlencode toTimestamp=2022-08-25T00:00:59.000Z

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

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

Query parameters

fromTimestampdatetimeRequired

toTimestampdatetimeRequired

sensorIdslist of stringsOptional

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.

objectIdstringOptionalformat: "^.{0,10000}$"<=10000 characters

placestringOptionalformat: "^.{0,10000}$"<=10000 characters

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

globalIdstringOptionalformat: "^.{0,10000}$"<=10000 characters

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

maxResultSizelongOptional1-100Defaults to 25

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

Response headers

Access-Control-Allow-OriginstringOptionalformat: "^.{0,10000}$"<=10000 characters

CORS header to allow cross-origin requests.

X-RateLimit-LimitintegerOptional

The maximum number of requests allowed in the current time period.

X-RateLimit-RemainingintegerOptional

The number of requests remaining in the current time period.

X-RateLimit-ResetintegerOptional

The time when the rate limit will be reset (Unix timestamp).

Response

Successful Operation.

uniqueObjectslist of objects

array of MTMCObject

batchIdstringformat: "^.{0,10000}$"<=10000 characters

globalIdstringformat: "^.{0,10000}$"<=10000 characters

timestampdatetime

enddatetime

objectTypestringformat: "^.{0,10000}$"<=10000 characters

matchedlist of objects

Errors

400

Bad Request Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error