Webhooks and Outputs

New in version 1.40.0.

info

• Direction of Travel has now been included in the response, represented as an angle in degrees ranging from 0 to 360 on a Unit Circle.
• Useful for cases such as detecting whether people are entering or exiting a gate.

CSV

PeopleTracker output is saved in a CSV file. You can use Notepad++ to get "live" updates in the CSV output file. Here is a sample CSV output:

timestamp,track_id,score,direction,file,box
2023-07-05T05:36:00.595948Z,1,0.895,82,/camera-1_screenshots/23-07-05/05-36-00.595948.jpg,"{'xmin': 619, 'ymin': 429, 'xmax': 646, 'ymax': 488}"
2023-07-05T06:10:35.722032Z,2,0.776,291,/camera-1_screenshots/23-07-05/06-10-35.722032.jpg,"{'xmin': 335, 'ymin': 114, 'xmax': 367, 'ymax': 167}"

JSON Lines

You may also output JSON Lines. Here is a sample JSONLines output:

{"camera_id": "camera-1", "filename": "08-59-54.183408.jpg", "timestamp": "2023-07-05T08:59:54.183408Z", "results": [{"box": {"xmin": 677, "ymin": 259, "xmax": 1213, "ymax": 932}, "type": "person", "score": 0.861, "track_id": 1, "direction": 358}]}
{"camera_id": "camera-1", "filename": "09-21-19.176125.jpg", "timestamp": "2023-07-05T09:21:19.176125Z", "results": [{"box": {"xmin": 705, "ymin": 334, "xmax": 1156, "ymax": 945}, "type": "person", "score": 0.911, "track_id": 2, "direction": 131}]}

Webhooks

PeopleTracker On-Premise uses webhooks to send notifications when a person is detected in the video stream. If there are multiple persons, PeopleTracker will send a separate request for each one.

Example webhook JSON data:

{
  "hook": {
    "target": "https://webhook.site/12345",
    "event": "people_detected"
  },
  "data": {
    "timestamp": "2023-11-15T09:21:49.730709Z",
    "results": [
      {
        "box": {
          "xmin": 282,
          "ymin": 39,
          "xmax": 305,
          "ymax": 103
        },
        "type": "person",
        "score": 0.9957417249679565,
        "track_id": 1,
        "direction": 95
      }
    ],
    "filename": "09-21-49.730709.jpg",
    "version": 1,
    "camera_id": "camera-1"
  }
}