Skip to main content
Version: 2.4.0 (latest)

Map Tracking

OMNI Agent can track the real-time location of people on a map of the office or outdoor area. This location is calculated through the spatial transformation of the coordinates of silhouettes obtained from one or more cameras. Map tracking requires individual calibration of each camera.

The tracking result is available through the API method /multistream_bodies.

Camera Calibration

  1. Enable the “Map Tracking” option in OMNI Agent Settings and follow the “Calibration cameras” link.

  2. Drag and drop the map image or upload it using the file manager.


  1. Select the camera for which you'll add the calibration points on the left.

  2. To add a calibration point, click the “+” next to the “Points” heading.

  3. In the “Map” tab, click on the location on the map where you want to set the calibration point. Then, in the “Camera Preview” tab, click on the approximate position of the same calibration point on the camera preview. As a result, points with the same serial number will appear on the map and the camera preview. The coordinates of the points will be added to the "Points" table.



  1. You can move (edit) the point if its position is incorrect. Just click on the point with the left mouse button and drag it to another position on the image.
  2. The more accurately the points match, the more accurate the calibration will be, and the more accurately the location of people will be displayed on the map.
  3. We reccomend to attach calibration points to the room floor and select these points at room corners and columns or doorways.
  4. The location of the calibration points should cover the floor surface as much as possible. If the points are very close to each other or on the same straight line, the calibration quality will be poor.
  1. After adding the 4th pair of calibration points, click “Save”.

  2. Close the "Camera Calibration Settings" tab to return to the map view.

  3. The room map should display people location in the field of view of all calibrated cameras.


To change the confidence detection threshold and the merge object distance threshold, click on “Settings” and specify the values in the opened window.


  • Confidence Detection Threshold: from 0 to 1, indicating the degree of confidence that the bbox contains a human body.
  • Merge Object Distance Threshold: from 0 to 1. All detections within this radius are folded into one, as they are considered to belong to the same person.