Blueforce Integration

The Blueforce connector allows users of Blueforce systems to send images to Nomad Media for AI processing. When whitelisted labels or faces are detected, Nomad Media makes a return web callback to Blueforce with the results.

Callback Structure

{
    "assetId": "d882faeb-108d-42e4-85cb-b3816954f17c",
    "date": "2021-08-30T20:05:23.9404047Z",
    "labels": [
        {
            "id": "0aab13f5-35d0-495e-81d6-14b779889eea",
            "labelName": "Balloon",
            "confidence": 92.19194793701172,
            "boundingBox": {
                "id": "85436c68-87ea-4612-a242-2fc5bfded576",
                "top": 0.23125000298023224,
                "left": 0.171171173453331,
                "height": 0.48124998807907104,
                "width": 0.6936936974525452
            }
        }
    ],
    "knownFaces": [
        {
            "id": "027ac183-8729-4553-9d58-412651eb0182",
            "confidence": 99.99857330322266,
            "boundingBox": {
                "id": "85436c68-87ea-4612-a242-2fc5bfded576",
                "top": 0.23125000298023224,
                "left": 0.171171173453331,
                "height": 0.48124998807907104,
                "width": 0.6936936974525452
            },
            "personName": "Tom Cruise",
            "personId": "d947a529-87f5-421d-9da7-ab56e53e8e6a"
        }
    ],
    "unknownFaces": [
        {
            "id": "51436c68-87ea-4612-a242-2fc5bfded576",
            "confidence": 99.99857330322266,
            "boundingBox": {
                "id": "85436c68-87ea-4612-a242-2fc5bfded576",
                "top": 0.23125000298023224,
                "left": 0.171171173453331,
                "height": 0.48124998807907104,
                "width": 0.6936936974525452
            }
        }
    ]
}

Callback Field Reference

Element	Description
`assetId`	The internal Nomad Media ID of the specific image where the detection occurred.
`labels`	The list of labels identified in the image.
`label.id`	The specific ID of that label. This ID is always the same for the same label across multiple images.
`label.labelName`	The description of the detected label.
`label.confidence`	Confidence percentage that the label is correctly identified.
`label.boundingBox`	Percentage coordinates of the detected item. The `id` represents a unique item in the image.
`knownFaces`	The list of faces that match a known person in the Nomad Media system.
`unknownFaces`	The list of faces detected but not currently assigned to a person.
`face.id`	The unique identifier of that specific face in that specific image.
`face.boundingBox`	Percentage coordinates of the identified face. The `id` represents the unique face in this image.
`face.confidence`	Confidence percentage that the bounding box correctly represents a face.
`face.personId`	The unique identifier of the identified person. This ID is consistent across all images.
`face.personName`	The name of the identified person.