Трекинг людей

Доступен · от 3 490 ₽/мес

Содержание

1. Обзор модуля

Модуль «Трекинг людей» отслеживает перемещения людей в зонах наблюдения. Подсчёт посетителей (вход/выход), время пребывания в зонах, тепловые карты активности, маршруты перемещений и обнаружение скоплений.

  • Подсчёт посетителей через линии подсчёта (вход/выход)
  • Зоны наблюдения с мониторингом времени пребывания
  • Тепловые карты активности (heatmap)
  • Отслеживание индивидуальных маршрутов (треки)
  • Обнаружение скоплений людей (crowd detection)
  • Алерты при превышении количества людей в зоне
  • Почасовая и дневная статистика посещаемости
  • Интеграция с умным домом (свет, кондиционер)

2. Быстрый старт

1
Подключите камеру
Добавьте IP-камеру. Рекомендуется установка сверху (потолочный монтаж) для точного подсчёта.
2
Создайте зону
Нарисуйте полигон зоны на кадре камеры — это область, в которой будут отслеживаться люди.
3
Добавьте линию подсчёта
Проведите линию на входе/выходе. Пересечение линии = вход или выход посетителя.
4
Запустите модуль
Система начнёт подсчёт и построение тепловых карт автоматически.
5
Анализируйте данные
Откройте раздел статистики для просмотра посещаемости, пиковых часов и маршрутов.

3. Зоны отслеживания

Зона — это полигон на кадре камеры. Система отслеживает, сколько людей находится внутри зоны, как долго они там находятся, и генерирует алерты при превышении лимита.

Параметры зоны:

  • name — название (напр. «Вход», «Кассовая зона», «Зал 2»)
  • polygon — координаты точек полигона на кадре
  • max_capacity — максимальное количество людей (для алертов)
  • alert_threshold — порог срабатывания алерта (в %)
  • current_count — текущее количество людей
  • avg_dwell_time — среднее время пребывания (секунды)

4. Линии подсчёта

Линия подсчёта — это отрезок на кадре. Когда человек пересекает линию, фиксируется событие «вход» или «выход» в зависимости от направления движения. Одна камера может иметь несколько линий подсчёта.

Параметры линии:

  • name — название (напр. «Главный вход»)
  • start / end — координаты начала и конца линии
  • direction — нормаль для определения направления (вход/выход)
  • total_in / total_out — счётчики входов и выходов

5. Тепловые карты

Тепловая карта показывает, где люди проводят больше всего времени. Данные накапливаются и доступны через API в виде матрицы значений (grid). Можно получить карту за любой период: час, день, неделю. 

GET /api/v1/tracking/{session_id}/heatmap?period=day

{
  "grid": [[0.1, 0.3, 0.8, ...], ...],
  "width": 64,
  "height": 48,
  "max_value": 127,
  "total_detections": 4521,
  "period": "day"
}

6. REST API

GET /api/v1/tracking/{id}/status Статус трекинга: зоны, людей, линии подсчёта
GET /api/v1/tracking/{id}/stats Статистика посещаемости за период
GET /api/v1/tracking/{id}/heatmap Тепловая карта (JSON-матрица)
GET /api/v1/tracking/{id}/events Последние события (вход, выход, скопление)
GET /api/v1/tracking/{id}/tracks Треки перемещений людей
POST /api/v1/tracking/{id}/zones Создать зону отслеживания
DELETE /api/v1/tracking/{id}/zones/{zone_id} Удалить зону
GET /api/v1/tracking/{id}/zones Список зон
POST /api/v1/tracking/{id}/lines Создать линию подсчёта
DELETE /api/v1/tracking/{id}/lines/{line_id} Удалить линию подсчёта
GET /api/v1/tracking/{id}/lines Список линий подсчёта
POST /api/v1/tracking/{id}/detect Отправить данные детекции для обработки

7. Рекомендации по камерам

Разрешение: минимум 1080p, рекомендуем 2K для залов >100 м²

Угол обзора: потолочный монтаж вертикально вниз — лучшая точность подсчёта

Высота установки: 3-5 метров для оптимального покрытия

Покрытие: одна камера покрывает зону ~8x6 м при высоте 4м

Освещение: равномерное освещение без резких теней. ИК для ночного режима

FPS: минимум 15 кадров/сек, рекомендуем 25 для точного трекинга

8. FAQ

Какая точность подсчёта?

При потолочном монтаже камеры — 95-98%. При боковом монтаже — 88-93%. После обучения на ваших данных — до 99%.

Отличает ли система вход от выхода?

Да. Линия подсчёта имеет направление. Пересечение слева направо = вход, справа налево = выход (настраивается).

Как строится тепловая карта?

Система фиксирует позицию каждого обнаруженного человека на каждом кадре. Данные аккумулируются в матрицу, которая доступна через API.

Сколько людей может отслеживать одна камера?

До 100 одновременно при разрешении 2K. При высокой плотности (толпа) точность отдельного трекинга снижается, но подсчёт остаётся точным.

Можно ли отслеживать конкретного человека?

Система присваивает каждому человеку анонимный ID на время нахождения в кадре. Распознавание лиц не производится — все данные анонимны.

Работает ли на улице?

Да. Модуль работает как в помещениях, так и на открытых площадках. Для улицы рекомендуем камеры с IP66 защитой.

Как интегрировать с умным домом?

Используйте сценарии Smart Home: человек вошёл → включить свет, зона пуста 5 минут → выключить кондиционер. Поддержка Home Assistant, Яндекс Алиса.

← Страница модуля Общая документация API →