⌂ > 🛠 Конфигурационный REST API > ⇄ Путь
PUT /configure/channels/{channel-id}/tracking : Изменение настроек модуля Трекинг🔗
Примечание
Доступно в версии Macroscop 4.6 и выше.
Предупреждение
Доступно только в лицензиях Enterprise и ULTRA.
Данный запрос может выполняться только пользователем с максимальными правами, то есть входящим в группу Старшие администраторы.
Важно
Во всех примерах указан локальный хост (localhost). При отправке реальных запросов замените его на адрес и порт сервера, на который отправляете запрос.
Параметры🔗
Параметр |
Описание |
Тип |
|---|---|---|
Enabled |
Включён ли модуль. Допустимые значения: true — включён, false — выключен |
bool |
ChannelSettings |
Настройки модуля Трекинг специфичные для конкретной камеры |
class |
.MinObjectSize |
Минимальный размер лица в кадре |
class |
.MaxObjectSize |
Максимальный размер лица в кадре |
class |
.DetectionMap |
Битовая маска зоны, описанная матрицей. Каждый элемент матрицы соответствует области кадра. Индекс элемента определяет положение соответствующей области кадра: [0, 0] — область в левом верхнем углу; [29, 39] — область в правом нижнем углу. Матрица 30 строк * 40 столбцов. Каждый элемент матрицы принимает значение 0 или 1: 0 — область кадра не входит в зону распознавания; 1 — область кадра входит в зону распознавания |
byte[,] |
.UseAdvancedTracking |
Включён ли фильтр по категориям. Допустимые значения: true — включён, false — выключен |
bool |
.AlertZones |
Массив зон генерации тревог. При передаче параметра с PUT-запросом весь массив изменяется как один объект (все старые значения заменяются новыми). Непустой массив |
class[] |
Примечание
Некоторые параметры необязательны для отправки PUT-запроса. Если для параметра не указано значение по умолчанию, он является обязательным. При отсутствии изменений система сохраняет текущее значение параметров.
Описание параметра ChannelSettings.MinObjectSize:
Параметр |
Описание |
Тип |
|---|---|---|
Width |
Минимальная ширина, выражаемая в долях от ширины кадра (например, 0.5 — половина ширины кадра). Допустимые значения: [0; 1], строго меньше MaxObjectSize.Width |
double? |
Height |
Минимальная высота, выражаемая в долях от высоты кадра (например, 0.5 - половина высоты кадра). Допустимые значения: [0; 1], строго меньше MaxObjectSize.Height |
double? |
Описание параметра ChannelSettings.MaxObjectSize:
Параметр |
Описание |
Тип |
|---|---|---|
Width |
Максимальная ширина, выражаемая в долях от ширины кадра (например, 0.5 - половина ширины кадра). Допустимые значения: [0; 1], строго больше MinObjectSize.Width |
double? |
Height |
Максимальная высота, выражаемая в долях от высоты кадра (например, 0.5 - половина высоты кадра). Допустимые значения: [0; 1], строго больше MinObjectSize.Height |
double? |
Параметр |
Описание |
Тип |
|---|---|---|
Id |
Идентификатор зоны. Строка, содержащая идентификатор в формате GUID |
GUID |
Name |
Название зоны. Непустая строка |
string |
Type |
Тип зоны. Допустимые значения: "LineIntersection" - генерация тревог при пересечении линии в указанном направлении AlertInfos[i].Direction, "MovingInZone" - генерация тревог при движении в зоне, "LongTimeMovingZone" - зона, при нахождении в которой время указанное в AlertZones[i].StayTimeSeconds генерируется тревога |
enum |
Points |
Зона, заданная массивом последовательно указанных через запятую вершин полигона. Вершина — точка, описанная в формате "x,y". Полигон — многоугольник, образованный замкнутой ломаной линией, не пересекающей самой себя. Зависит от значения AlertZone.Type. "LineIntersection": Массив, содержащий ровно 2 точки в формате "x,y", образующие отрезок внутри кадра. "MovingInZone": Массив, содержащий минимум 3 точки в формате "x,y". Точки должны быть указаны в таком порядке, чтобы при последовательном их соединении отрезками, отрезки бы не пересекали друг друга. |
Point[] |
Direction |
Направление, в котором засчитывается пересечение линии, когда AlertZone.Type имеет значение "LineIntersection". "DirectionOne" - первое направление; "DirectionSecond" - второе направление; "Both" - оба направления. |
enum |
DetectionClasses |
Массив категорий подсчитываемых объектов. Массив, содержащий хотя бы 1 из значений, когда включен фильтр по категориям UseAdvancedTracking: "Person" - Люди; "Animal" - Животные; "Vehicle" - Транспортные средства. |
enum[] |
DetectionSubClasses |
Массив категорий транспортных средств. Учитывается, когда DetectionClasses содержит "Vehicle". Массив должен содержать хотя бы 1 из значений, если DetectionClasses содержит "Vehicle": "Car" - Легковые автомобили; "Bus" - Автобусы; "Truck" - Грузовые автомобили; "Motorbike" – Мотоциклы. |
enum[] |
StayTimeSeconds |
Время, необходимое для генерации тревоги в зоне c типом AlertZones[i].Type равным "LongTimeMovingZone". Доступные значения: [1; 300] |
enum[] |
Пример запроса🔗
PUT http://localhost:8080/configure/channels/81060b4d-7f0c-47af-8ec1-124dc79fd750/tracking