v1

latestOpenAPI 3.0.3Apache 2.02026-07-175678720.5 KB
frames

Get enhanced frame metadata

get/frames/enhanced

Query parameters

sensorIdstring required
frameIdstring

This parameter is incompatible with maxResultSize, timestamp or time range params (fromTimestamp and toTimestamp). Only one of them can exist in the query.

timestampstring date-time

This parameter is used for querying enhanced frame at a particular point of time. It is incompatible with maxResultSize, frameId or time range params (fromTimestamp and toTimestamp). Only one of them can exist in the query.

fromTimestampstring date-time

This parameter is used for querying enhanced frames in a time range. It is incompatible with timestamp or frameId. Only one of them can exist in the query.

toTimestampstring date-time

This parameter is used for querying enhanced frames in a time range. It is incompatible with timestamp or frameId. Only one of them can exist in the query.

maxResultSizeinteger

This parameter is incompatible with timestamp or frameId. Only one of them can exist in the query.

Response

Successful Operation.

Example response

{
  "enhancedFrames": [
    {
      "version": "1",
      "id": "1",
      "objects": [
        {
          "bbox": {
            "topY": 0.5,
            "rightX": 1.7,
            "bottomY": 0.8,
            "leftX": 0.6,
            "embeddings": [
              {
                "vector": [
                  0.1
                ]
              }
            ],
            "confidence": 0.95,
            "info": {
              "additionalProperty1": "value1",
              "additionalProperty2": "value2"
            }
          },
          "type": "Person",
          "id": "1",
          "location": {
            "lat": 24.5,
            "lon": 15.4,
            "alt": 19.7
          },
          "coordinate": {
            "x": 4.5,
            "y": 1.7,
            "z": 2.7,
            "info": {
              "additionalProperty1": "value1",
              "additionalProperty2": "value2"
            }
          }
        }
      ],
      "sensorId": "cam-1",
      "socialDistancing": {
        "clusters": [
          {
            "points": [
              {
                "x": 1.1,
                "y": 0.5
              }
            ]
          }
        ]
      },
      "rois": [
        {
          "id": "hazard_zone_1",
          "type": "Person"
        }
      ],
      "fov": [
        {
          "id": "1",
          "type": "Person"
        }
      ],
      "info": {
        "additionalProperty1": "value1",
        "additionalProperty2": "value2"
      }
    }
  ]
}