AXIS Direction Detector

Общие сведения о решении

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

AXIS Direction Detector

Детектор направления AXIS Direction Detector представляет собой аналитическое программное приложение, которое отслеживает направление движения людей, проходящих под камерой. Если человек двигается в одном из направлений, приложение может генерировать сигнал тревоги.

Детектор направления AXIS Direction Detector имеет функцию счетчика AXIS People Counter.

Установка камеры

ПРИМЕЧАНИЕ

Это приложение предназначено для случаев применения, когда необходимо выполнять подсчет объектов с характеристиками взрослого человека. Точное значение максимальной высоты объекта зависит от модели камеры, объектива камеры и выбранной чувствительности счетчика.

Помимо инструкций, приведенных в руководстве по установке камеры, необходимо выполнить еще некоторые важные действия, чтобы гарантировать правильную работу приложения:

  • Рекомендуется установить камеру на высоте не менее 270 см.

  • Общее правило состоит в том, что ширина области наблюдения камеры равна высоте, на которой она установлена. Подробные сведения о конкретных моделях камер содержатся в разделе Селектор камер для AXIS People Counter

  • После установки камеры размер ее области наблюдения можно увеличить в зависимости от заданного значения трансфокации.

  • Если камера установлена достаточно высоко, можно получить ширину охвата 8 метров. Используя несколько счетчиков, можно вести видеонаблюдение даже в случае еще более широких входов.

  • Камеру необходимо установить непосредственно над тем местом, где проходят люди.

  • Убедитесь в том, что камера направлена вертикально вниз, перпендикулярно потолку.

  • Если установить приложение до того, как будет установлена камера, для регулировки положения камеры можно будет использовать область подсчета, которая отображается в режиме живого просмотра. Область подсчета должна располагаться слева направо, перпендикулярно направлению движения людей.

  • Убедитесь в том, что на объекте достаточный уровень освещенности с помощью белого света или ИК-подсветки.

  • Убедитесь в том, что в области подсчета нет постоянно перемещающихся объектов. Например, не следует устанавливать камеру над эскалатором.

  • Убедитесь в отсутствии мешающих движущихся объектов в области подсчета. Например, не следует устанавливать камеру слишком близко к двери.

  • Старайтесь, чтобы в поле зрения камеры не попадал слишком яркий свет, например, от солнца и не было резких теней.

Поиск устройства в сети

Для поиска устройств Axis в сети и назначения им IP-адресов в Windows® можно использовать приложение AXIS IP Utility или AXIS Device Manager. Оба эти приложения можно бесплатно скачать на странице axis.com/support.

Дополнительные сведения о поиске устройств и назначении IP-адресов см. в документе How to assign an IP address and access your device (Как назначить IP-адрес и получить доступ к устройству).

Доступ к устройству

  1. Откройте браузер и введите IP-адрес или имя хоста устройства Axis.

    Если вы не знаете IP-адрес, используйте утилиту AXIS IP Utility или приложение AXIS Device Manager, чтобы найти устройство в сети.

  2. Введите имя пользователя и пароль. Для доступа к устройству в первый раз необходимо задать пароль root. См. Установка нового пароля для учетной записи root.

  3. При этом в браузере откроется страница живого просмотра.

Безопасные пароли

Важно!

Устройства Axis передают первоначально установленный пароль по сети в текстовом виде. Чтобы защитить свое устройство, после первого входа в систему настройте безопасное зашифрованное HTTPS-соединение, а затем измените пароль.

Пароль устройства — это основное средство защиты ваших данных и сервисов. Для устройств Axis не предусмотрена собственная политика использования паролей, так как эти устройства могут входить в состав систем разного типа и назначения.

Для защиты данных мы настоятельно рекомендуем соблюдать указанные ниже правила.

  • Используйте пароль длиной не менее 8 символов. Желательно создать пароль с помощью генератора паролей.

  • Никому не сообщайте пароль.

  • Периодически меняйте пароль — хотя бы раз в год.

Установка нового пароля для учетной записи root

Важно!

По умолчанию для учетной записи администратора используется имя пользователя root. Если пароль для пользователя root утрачен, необходимо произвести сброс параметров устройства к заводским установкам. См. раздел .

Совет службы поддержки. Проверка надежности пароля
  1. Введите пароль. Соблюдайте инструкции по созданию надежных паролей. См. Безопасные пароли.

  2. Введите пароль еще раз для подтверждения.

  3. Нажмите Create login (Создать сведения для входа). Пароль задан.

Установка приложения в камеру

Примечание.
  • Лицензия относится только к одной камере. Нельзя активировать лицензию на другой камере, не имея нового ключа для регистрации.
  • Для установки приложений на камеру требуются права администратора.
  1. Установите камеру в своей сети.

  2. Перейдите на веб-страницу камеры в браузере (см. руководство пользователя камеры).

  3. Перейдите к пункту Apps (Приложения).

  4. Загрузите файл приложения (.eap) в камеру.

  5. Активируйте лицензию. Подключившись к Интернету, введите код лицензии. Приложение автоматически активирует лицензию.

Активация лицензии в автономном режиме

  1. Для активации лицензии в автономном режиме необходимо иметь лицензионный ключ. При отсутствии лицензионного ключа на компьютере сделайте следующее:
  2. Откройте страницу www.axis.com/applications

  3. Перейдите в раздел License key registration (Регистрация лицензионного ключа). Вам потребуется код лицензии и серийный номер устройства Axis.

  4. Сохраните файл с лицензионным ключом на компьютере и выберите этот файл, когда от приложения поступит соответствующий запрос.

Доступ к настройкам приложения

  1. На веб-странице камеры перейдите к пункту Apps (Приложения), запустите приложение и нажмите кнопку Open (Открыть).

Расширенные настройки

Установка даты и времени

Для камеры важно сохранять правильные настройки даты и времени в течение длительного периода, чтобы можно было соотнести статистические данные с соответствующим отрезком времени. Дата и время задаются на веб-странице камеры.

  1. На веб-странице камеры перейдите в раздел System > Date and time (Система > Дата и время).

  2. Для получения более подробной информации о настройках даты и времени нажмите .

Создание учетной записи пользователя

Можно создавать учетные записи пользователей с разными правами, чтобы, например, неуполномоченные сотрудники могли видеть статистические данные, но не могли изменить какие-либо параметры счетчика.

Учетные записи пользователей создаются на веб-странице камеры.

  1. На веб-странице камеры перейдите в раздел System > Users (Система > Пользователи).

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

Настройка счетчика

Чтобы проверить, требуется ли калибровка приложения для вашей камеры, откройте средство Селектор камер для AXIS People Counter.

  1. На веб-странице приложения выберите Settings > General (Настройки > Общие).

  2. При этом должна быть включена кнопка Status (Состояние).

  3. В поле Name (Имя) введите имя камеры или ее местоположение.

    Это может быть, например, «Axis_MainEntrance_T_building». Все камеры должны иметь уникальные имена.

  4. Выберите Calibration mode (Режим калибровки). Выполните одно из следующих действий:

    • Если приложение откалибровано для вашей камеры, выберите Настройка высоты. Введите высоту, на которой установлена камера, в поле Визуальная высота.

    • Если приложение не откалибровано, выберите Ручная настройка и нажмите кнопку Настройка. Поставьте человека под камеру и отрегулируйте размер желтого прямоугольника таким образом, чтобы он покрывал изображение только одного человека.

  5. Если необходимо использовать трансфокацию, чтобы увеличить изображение, выполните одно из следующих действий:

    • Включите Цифровой зум и нажмите кнопку Настройка.

    • Если камера имеет оптический зум, необходимо открыть веб- страницу камеры, чтобы задать степень увеличения.

  6. В зависимости от направления, в котором проходят люди в окне живого просмотра, задайте для параметра Направление входа значение Вверх или Вниз.

  7. Чтобы отрегулировать область подсчета, см. раздел Настройка зоны подсчета.

Настройка зоны подсчета

Примечание.

Возможности регулировки области подсчета определяются как моделью камеры, так и высотой, на которой установлена камера.

На изображении в режиме живого просмотра область подсчета обозначается двумя синими линиями, между которыми находится красная область. Человек учитывается при подсчете, если он проходит через красную область.

Форму области подсчета можно менять с помощью параметров кривизны так, чтобы она имела удобный вид и люди естественным образом проходили через эту область. Старайтесь использовать параметры кривизны таким образом, чтобы получались углы, максимально близкие к 180 градусам.

  1. Перейдите в меню Settings > Counting zone (Настройки > Зона подсчета).

  2. Для перемещения всей области подсчета вверх или вниз используйте ползунок Line offset (Смещение линии). Возможный диапазон перемещения этой линии зависит от размера области подсчета.

  3. Чтобы настроить высоту области подсчета, используйте ползунок Counting zone height (Высота зоны подсчета).

  4. Чтобы настроить ширину области подсчета, используйте ползунок Counting zone width (Ширина зоны подсчета). Возможный диапазон изменения ширины будет зависеть от высоты установки камеры.

  5. Чтобы использовать криволинейную область подсчета, включите параметр Curved line (Изогнутая линия), а затем отрегулируйте радиус, используя ползунок Radius (Радиус).

  6. Для изменения направления кривизны нажмите значок Radius (Радиус).

  7. Нажмите кнопку Submit (Отправить), чтобы сохранить настройки, когда закончите.

  8. Возможно, придется выполнить точную настройку счетчика для получения наилучших результатов, см. раздел Проверка системы.

Соседние счетчики для широких входов

ПРИМЕЧАНИЕ

Эту функцию можно использовать только для камер одинаковой модели.

Если есть широкий вход, который требует установки нескольких счетчиков, то можно настроить несколько камер и создать Neighbor counters (Соседние счетчики). Чтобы рассчитать необходимое количество камер для покрытия всей ширины входа, используйте средство селектор камер для AXIS People Counter.

Основная камера переопределяет следующие параметры в дополнительных камерах:

  • Visual height (Визуальная высота)

  • Counter sensitivity (Чувствительность счетчика)

  • Digital zoom (Цифровой зум)

  • Network & time (Сеть и время)

  • Смещение линии

  • Высота зоны подсчета

  • Расписание подсчета

Настройка соседних счетчиков

  1. Установите камеры рядом друг с другом в соответствии с их размерами, которые указаны в селекторе камер.

  2. Перейдите на веб-страницу приложения основной камеры и выберите Settings > Advanced > Neighbor counters (Настройки > Дополнительно > Соседние счетчики).

  3. Выберите параметр Enable as primary (Сделать основной камерой).

  4. Для каждой дополнительной камеры необходимо перейти к пункту Settings > Advanced > Neighbor counters > Display camera credential (Настройки > Дополнительно > Соседние счетчики > Показать учетные данные доступа к камере) и скопировать следующие учетные данные:

    • IP address (IP-адрес): URL-адрес камеры

    • Username (Имя пользователя): автоматически установлено значение AxisAnalytics

    • Password (Пароль): создается автоматически

  5. Вернитесь на веб-страницу основной камеры и вставьте скопированные учетные данные в форму в разделе Neighbor counters (Соседние счетчики).

  6. Если для камер настроена передача данных в приложение AXIS Store Data Manager, убедитесь в том, что подключена только основная камера. Основная камера автоматически передает данные со всех дополнительных камер в виде единого блока данных.

  7. После подключения всех камер перейдите к пункту Calibrate secondary position (Калибровка положения дополнительных камер).

  8. Разместите объект (например, лист бумаги) точно посередине между двумя камерами. Очень важно разместить объект точно посередине между двумя камерами, поскольку этот объект будет использоваться в качестве эталонной точки для калибровки камер.

  9. Перетащите вид с дополнительной камеры на вид с основной камеры. Старайтесь избегать смещения по вертикали.

    1. Вид с основной камеры
    2. Вид с дополнительной камеры
    3. Эталонный объект
  10. После завершения калибровки перейдите к пункту Live view (Живой просмотр) основной камеры для просмотра изображений со всех дополнительных камер.

Если в окне главной камеры не отображаются видеопотоки с дополнительных камер, проверьте, нет ли у работающих дополнительных камер других подключений.

Как инициировать событие

  1. Выберите в меню Настройки > AXIS Direction Detector для перехода на веб-страницу камеры.

  2. При настройке событий используйте триггер Приложения.

  3. Следуйте встроенным инструкциям, чтобы настроить событие в камере.

Настройка расписания

Приложение автоматически отключает функцию подсчета, когда становится темно. Если требуется дополнительно ограничить подсчет, можно настроить расписание.

  1. Перейдите в меню Settings > Counting schedule (Настройки > Расписание подсчета).

  2. Чтобы отрегулировать время начала и окончания, переместите любой из ползунков. Чтобы задать отдельное расписание для каждого дня недели, выберите пункт Per day schedule (Расписание на каждый день) и используйте соответствующие ползунки.

Отключение приложения в определенный день недели

Снимите флажок рядом с ползунком.

Анонимизация людей

Приложение можно настроить таким образом, чтобы нельзя было идентифицировать людей, которые были зафиксированы камерой. Существует два уровня анонимизации: частичный и полный.

Частичная анонимизация

Эта функция блокирует все видеопотоки и изображения с камеры. В режиме живого просмотра отображаются размытые изображения. Это означает, что вы по-прежнему можете видеть, что происходит, но не можете идентифицировать людей.

  1. Перейдите в меню Maintenance > Anonymize (Обслуживание > Анонимизация).

  2. Выберите Anonymize soft (Частичная анонимизация).

  3. Чтобы вернуться в обычный режим, нажмите кнопку Reset anonymization (Сбросить анонимизацию). Это могут сделать только пользователи с учетной записью администратора.

Полная анонимизация

Важно!

При полной анонимизации удаляются все пользователи с правами администратора и блокируется пароль root. Отмена возможна только с помощью сброса к заводским установкам по умолчанию на камере.

  1. Перейдите в меню Maintenance > Anonymize (Обслуживание > Анонимизация).

  2. Выберите Anonymize hard (Полная анонимизация).

Копирование настроек приложения для другой камеры

Используйте функцию копирования, если вы хотите скопировать настройки приложения, например, для других камер, установленных в том же магазине на такой же высоте. Лицензия на приложение и название камеры — это информация, относящаяся к конкретной камере, и она не подлежит копированию.

  1. Чтобы скопировать настройки приложения, перейдите в меню Обслуживание > Копирование параметров.

  2. Нажмите кнопку Копировать. Компьютер сохраняет файл в папке «Загрузки», которая по умолчанию задана в браузере.

Проверка системы

Примечание.

Прежде чем проверять систему, убедитесь в том, что камера установлена в соответствии с рекомендациями. См. Установка камеры.

После установки и настройки всех камер в здании, рекомендуется проверить точность и тонкую настройку системы. Это может повысить точность или выявит какие-то проблемы, связанные со счетчиком.

Чтобы получить общее представление, откройте в меню Статистические данные и посмотрите, какие были результаты подсчета пару дней назад. Если разница между количеством входящих и выходящих людей не превышает 5 %, то это хороший первый признак правильной настройки системы.

Если разница больше, следуйте инструкциям, приведенным в разделе Проверка счетчика.

Проверка счетчика

  1. Перейдите в меню Live view (Живой просмотр).

  2. Нажмите Test accuracy (Проверка точности).

  3. Нажмите кнопку Hide (Скрыть), чтобы скрыть автоматический счетчик.

  4. Нажмите кнопку Start (Пуск) и вручную посчитайте 100 или более прошедших людей, нажимая на клавиатуре клавиши со стрелками вверх и вниз. Можно также нажимать кнопку In (Вход) и Out (Выход).

  5. Чтобы начать подсчет сначала, нажмите кнопку Reset (Сброс).

  6. Нажмите кнопку Result (Результат), когда закончите.

  7. Определите точность по таблице. При нормальных условиях общая точность должна составлять 95 % или больше.

Если вас не удовлетворяет точность счетчика, см. раздел Точная настройка счетчика.

Точная настройка счетчика

  1. Убедитесь в том, что камера установлена в соответствии с инструкциями, приведенными в разделе Установка камеры.

  2. Выберите в меню Settings > General (Настройки > Общие).

  3. Найдите ползунок, регулирующий Counter sensitivity (Чувствительность счетчика), или нажмите кнопку Setup (Настройка), если счетчик работает в ручном режиме, и выполните одно из следующих действий:

    • Если результаты подсчета слишком велики по сравнению с контрольным значением, следует уменьшить чувствительность счетчика примерно на 20 единиц или слегка увеличить размер желтого прямоугольника.

    • Если результаты подсчета слишком малы по сравнению с контрольным значением, следует увеличить чувствительность счетчика примерно на 20 единиц или слегка уменьшить размер желтого прямоугольника.

  4. Проверьте точность повторно, см. раздел Проверка счетчика.

Статистика

Существует несколько способов использования статистических данных, получаемых с помощью счетчика:

  • На веб-странице приложения можно просматривать данные подсчета в виде графиков, которые строятся в режиме реального времени.

  • На странице статистических данных можно просматривать встроенные графики с результатами подсчета за день и за неделю. Обновление данных происходит в режиме реального времени.

    Данные доступны для просмотра в камере до 90 дней; обновление происходит каждые 15 минут. Данные, полученные за 15 минут, хранятся в соответствующих ячейках; эти данные представляют собой количество людей, которые вошли и вышли за 15 минут.

  • Возможна загрузка данных посредством открытого интерфейса API. См. раздел, посвященный библиотеке VAPIX®.

  • Используйте AXIS Store Data Manager, программный пакет для централизованного хранения и управления данными, которые собираются со всех устройств. См. Подключение камеры к папке в AXIS Store Data Manager.

  • Используйте AXIS Store Reporter, веб-решение для управления и отслеживания исторических данных.

  • О загрузке статистических данных на свой компьютер см. раздел Загрузка статистических данных.

Подключение камеры к папке в AXIS Store Data Manager

Чтобы выполнить эту задачу, необходимо установить приложение на камере.

  1. В приложении AXIS Store Data Manager откройте меню Sources (Источники) и получите Folder connection identifier (Идентификатор для подключения к папке), а также Folder connection password (Пароль для подключения к папке) для папки, к которой требуется подключить камеру.

  2. На веб-странице камеры перейдите к пункту Settings > Apps (Настройки > Приложения) и откройте веб-страницу приложения.

  3. На веб-странице приложения перейдите к пункту Settings > Reporting (Настройки > Создание отчетов).

  4. Чтобы включить передачу данных на сервер по технологии push, выберите Enabled (Включено).

  5. Введите веб-адрес для AXIS Store Data Manager, например, https://[systemintegrator1].asdm.axis.com/datamanager, где [systemintegrator1] заменяется уникальным именем.

  6. Введите Folder connection identifier (Идентификатор для подключения к папке) и Folder connection password (Пароль для подключения к папке).

  7. Чтобы проверить соединение, нажмите Run test (Выполнить тестирование).

  8. Нажмите Submit (Отправить).

Загрузка статистических данных

  1. Перейдите к пункту Statistics > Download statistics (Статистика > Скачать статистику).

  2. Выберите формат файла:

    • Если выбран формат XML, CSV или JSON, также можно указать временной интервал.

    • Из соображений совместимости также доступен проприетарный двоичный формат CNT.

  3. Выберите дату в календаре. Данные будут отображены в новой вкладке в браузере.

  4. Если вы хотите сохранить данные в виде локального файла на компьютере, щелкните правой кнопкой мыши и выберите Save as (Сохранить как). Браузер сохранит файл на компьютере в папке загрузок по умолчанию.

  5. Чтобы скачать все доступные данные, выберите Download all (Скачать все) рядом с форматом файла.

Устранение неполадок

ПроблемаДействие
Не загружается программное обеспечение в AXIS Store Data Manager.Наиболее распространенной причиной является неполадка в подключении к сети. Для получения сведений об истинной причине этой проблемы запустите тестирование соединения, выбрав в меню Settings > Reporting (Настройки > Создание отчетов).
Программное обеспечение не выполняет подсчет.Убедитесь, что при установке камеры были соблюдены соответствующие инструкции, см. Установка камеры.
Программное обеспечение выполняет подсчет неправильно.Убедитесь в том, что люди проходят через всю область подсчета, пересекая обе синие линии. Люди не должны выходить из этой области налево или направо до пересечения обеих линий.
Нет видеопотока в режиме живого просмотра.Убедитесь в том, что никто больше не смотрит видео; проверьте, что видеопоток передается в ПО для управления видео или ведется запись. Проверьте, не задано ли для камеры ограничение по максимально допустимому количеству зрителей или видеопотоков, которые могут присутствовать одновременно.
В приложении появляется уведомление о том, что частота кадров слишком низкая.1. Проверьте, насколько хорошо освещена область наблюдения. Если она слишком темная, то частота кадров, используемая в камере, недостаточна для нормальной работы приложения.
2. Если процессор камеры работает с высокой нагрузкой, это может негативно отразиться на работе приложения. При потоковой передаче видео с камеры следует проверять, чтобы в каждый момент времени был открыт только один поток.
Программное приложение перестало вести подсчет после изменения параметров.После изменения параметров приложение должно поработать около 10 минут, чтобы обеспечить высокую точность подсчета.
Мне никак не удается заставить приложение вести подсчет.Если вы выполнили представленные выше рекомендации, но приложение по-прежнему не работает, обратитесь к реселлеру Axis.

Перезапуск приложения

Если результаты подсчета неточны или веб-интерфейс работает необычно медленно, можно попытаться перезапустить работающие службы или перезапустить устройство.

Чтобы перезапустить устройство, перейдите к пункту Maintenance > Restart (Обслуживание > Перезапуск).

Сброс приложения

Перейдите в меню Maintenance > Reset (Обслуживание > Сброс) и выполните одно из следующих действий:

  • Чтобы удалить из камеры все результаты подсчета, нажмите кнопку Очистить данные.

  • Чтобы восстановить исходные настройки приложения, заданные по умолчанию, нажмите кнопку Восстановить параметры.

Резервное копирование настроек

  1. Чтобы создать резервную копию параметров приложения, перейдите в меню Maintenance > Parameter backups (Обслуживание > Резервные копии параметров).

  2. Нажмите кнопку Резервное копирование. Компьютер сохраняет файл в папке «Загрузки», которая по умолчанию задана в браузере.

Восстановить настройки

  1. Перейдите в меню Maintenance > Parameter backups (Обслуживание > Резервное копирование параметров).

  2. Используя функцию обзора, выберите ранее сохраненный резервный файл и нажмите кнопку Восстановить.

Создание отчета журнала

При возникновении любых проблем с устройством можно создать отчет журнала.

  1. Перейдите к пункту Maintenance > Logs (Обслуживание > Журналы).

  2. Нажмите кнопку Generate logs (Создать журналы).

  3. Файл журнала сохраняется на компьютере в папку загрузок, используемую в браузере по умолчанию.

  4. Отправляя запрос в службу поддержки, приложите к нему этот отчет журнала.

Управление лицензиями

Перейдите в меню Maintenance > Registration (Обслуживание > Регистрация).

  • Чтобы зарегистрировать лицензию, нажмите кнопку Registration page (Страница регистрации).

  • Если вы хотите удалить лицензию с данного устройства, нажмите кнопку Удалить регистрацию.

  • Если вы обновили лицензию, нажмите кнопку Обновить лицензию.

Легкая версия веб-интерфейса

Легкую версию веб-интерфейса можно найти по URL-адресу http://<servername>/people-counter/lite/index.html. Эти страницы можно использовать, например, для встраивания приложения в те или иные системы. В частности, это может быть AXIS Camera Station или клиент XProtect Smart Client компании Milestone Systems.

Имеются четыре страницы:

  • http://<servername>/people-counter/lite/day.html: На странице отображается график в течение дня; этот же график можно посмотреть в меню Статистические данные.

  • http://<servername>/people-counter/lite/week.html: На странице отображается график в течение недели; этот же график можно посмотреть в меню Статистические данные.

  • http://<servername>/people-counter/lite/count.html: На странице отображаются результаты подсчета в режиме живого просмотра за текущий день.

  • http://<servername>/people-counter/lite/liveview.html: Компактная версия страницы живого просмотра, на которой представлены результаты подсчета в режиме живого просмотра и видеопоток с наложенной на него областью подсчета.

Меню в нижней части страницы можно отключить, добавив текст «?clean» в указанный выше URL-адрес, например, http://<servername>/people-counter/lite/liveview.html?clean. Можно также вставить тег языка перед словом «lite», чтобы эти страницы отображались на других языках, например, http://<servername>/people-counter/cn/lite/liveview.html

Интерфейс API приложений для подсчета людей

Функцию подсчета людей имеют следующие приложения:

AXIS People Counter –
Приложение для подсчета людей AXIS People Counter предназначено для предприятий розничной торговли — магазинов, торгово-развлекательных центров или других мест, где нужна информация о количестве людей.
AXIS Occupancy Estimator –
Это приложение отслеживает текущее количество людей в некоторой замкнутой зоне. Приложение может также оценить, сколько времени в среднем человек проводит в этой зоне.
AXIS Direction Detector –
Приложение определяет направление движения людей, проходящих под камерой. Если человек двигается в одном из направлений, приложение может генерировать сигнал тревоги.
AXIS Tailgating Detector –
Приложение обнаруживает факт прохода нескольких человек под камерой в течение заданного промежутка времени. При обнаружении более одного человека, приложение может подать сигнал тревоги.
AXIS Random Selector –
Приложение обнаруживает, когда кто-либо выходит из помещения и случайным образом определяет, следует ли назначить проверку местонахождения данного человека или нет.

Распространенные примеры

Примечание.

Значение <appname> в разных примерах указывает конкретное приложение в соответствии с приведенной таблицей.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Example

Создайте запрос на получение данных от счетчика AXIS People Counter в режиме реального времени.

Запрос
http://<servername>/local/<appname>/.api?live-sum.json
Возвращаемое значение
{
  "serial":"00408CAC512B",
  "name":"Exit south",
  "timestamp":"20170503112756",
  "in":12,
  "out":318
}

Для получения дополнительных сведений см. Запрос на получение данных в режиме реального времени.

Example

Получить список всех дней, для которых есть данные счетчика AXIS People Counter.

Запрос
http://<servername>/local/<appname>/.api?list-cnt.json
Возвращаемое значение
{
  "timestamp" : "20170513132513",
  "days":["20170510", "20170511", "20170513"]}
}

Для получения дополнительных сведений см. Список доступных данных.

Example

Создать запрос на получение исторических данных за 12–15 мая 2017 г.

Запрос
http://<servername>/local/<appname>/.api?export-cnt&date=20170512-20170515

Для получения дополнительных сведений см. Загрузка двоичных данных.

Example

Создать запрос на получение всех доступных исторических данных.

Запрос
http://<servername>/local/<appname>/.api?export-cnt&date=all

Для получения дополнительных сведений см. Загрузка двоичных данных.

Example

Создать запрос на получение исторических данных в формате CSV за 12 мая и 15 мая 2017 г. с разрешением 15 минут.

Запрос
http://<servername>/local/<appname>/.api?export-csv&date=20170512,20170515&res=15m

Для получения дополнительных сведений см. Запрос на получение данных CSV.

Example

Создать запрос на получение исторических данных для всех доступных дней с разрешением 24 часа.

Запрос
http://<servername>/local/<appname>/.api?export-csv&date=all&res=24h

Для получения дополнительных сведений см. Запрос на получение данных CSV.

Example

Создать запрос на получение исторических данных в формате XML за 12 мая и 15 мая 2017 г. с разрешением 15 минут.

Запрос
http://<servername>/local/<appname>/.api?export-xml&date=20170512,20170515&res=15m

Для получения дополнительных сведений см. Запрос на получение данных XML.

Example

Создать запрос на получение информации от счетчика AXIS People Counter в режиме живого просмотра.

Запрос
http://<servername>/local/<appname>/.api?cntpos.json
Ответ
{
  "width":320,
  "height":240,
  "left":0,
  "right":296,
  "top":88,
  "bottom":224,
  "yfirst":88,
  "ylast":152,
  "radius":0
}

Для получения дополнительных сведений см. Сведения о живом просмотре.

Спецификация API

Запрос на получение данных в режиме реального времени

Возвращается файл JSON с результатами подсчета в режиме реального времени.

Формат:
JSON
Метод:
GET
Запрос
http://<servername>/local/<appname>/.api?live-sum.json

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Возвращаемое значение
{
  "serial":"<camera-serial>",
  "name":"<counter-name>",
  "timestamp":"<timestamp>",
  "in":<in>,
  "out":<out>
}
Описания возвращаемых значений
ЗначениеОписание
<camera-serial>серийный номер камеры
<counter-name>имя счетчика
<timestamp>время в камере в формате ГГГГММДДччммсс
<in>количество людей, которые вошли сегодня до настоящего момента
<out>количество людей, которые вышли сегодня до настоящего момента

Список доступных данных

Возвращается список дней, для которых есть данные.

Формат:
JSON
Метод:
GET
Запрос
http://<servername>/local/<appname>/.api?list-cnt.json

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Возвращаемое значение
{
  "timestamp" : "<timestamp>",
  "days":["YYYYMMDD", [..] "YYYYMMDD"]}
}
Описания возвращаемых значений
ЗначениеОписание
<timestamp>время в камере в формате ГГГГММДДччммсс
<days>массив дней, для которых есть данные

Загрузка двоичных данных

Этот скрипт возвращает файл с двоичными данными для заданной даты (или нескольких дат) для использования в приложении AXIS Store Data Manager

Формат:
cnt
Метод:
GET
Запрос
http://<servername>/local/<appname>/.api?export-cnt&date=<date>

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Описания запрошенных параметров
ПараметрОписание
<date>дата в виде ГГГГММДД
интервал дат в виде ГГГГММДД-ГГГГММДД
даты, разделенные запятыми, в виде ГГГГММДД,[..],ГГГГММДД
все для всех доступных данных

Возвращаемое значение

Файл с двоичными данными для заданных дат.

Запрос на получение данных CSV

Возвращаются исторические данные в формате CSV

Формат:
CSV
Метод:
GET
Запрос
http://<servername>/local/<appname>/.api?export-csv[&date=<date>][&res=<res>]

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Описания запрошенных параметров
ПараметрОписание
<date>дата в виде ГГГГММДД
интервал дат в виде ГГГГММДД-ГГГГММДД
даты, разделенные запятыми, в виде ГГГГММДД,[..],ГГГГММДД
все (по умолчанию) для всех доступных данных
<res>15 мин (по умолчанию) для данных в 15-минутных ячейках
1 ч для данных в 1-часовых ячейках
24 ч для данных в суточных ячейках

Возвращаемое значение

Этот скрипт возвращает данные в простом текстовом формате, в виде значений, разделенных запятыми. Первая строка содержит описание каждого элемента, а следующие строки содержат соответствующие данные для выбранного периода времени и разрешения.

Запрос на получение данных XML

Возвращаются исторические данные в формате XML

Формат:
XML
Метод:
GET
Запрос
http://<servername>/local/<appname>/.api?export-xml[&date=<date>][&res=<res>]

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Описания запрошенных параметров
ПараметрОписание
<date>дата в виде ГГГГММДД
интервал дат в виде ГГГГММДД-ГГГГММДД
даты, разделенные запятыми, в виде ГГГГММДД,[..],ГГГГММДД
все (по умолчанию) для всех доступных данных
<res>15 мин (по умолчанию) для данных в 15-минутных ячейках
1 ч для данных в 1-часовых ячейках
24 ч для данных в суточных ячейках

Возвращаемое значение

Этот скрипт возвращает данные в формате XML. Файл DTD можно найти по адресу http://<servername>/local/<appname>/appdata.dtd.

Запрос на получение данных JSON

Возвращаются исторические данные в формате JSON

Формат:
JSON
Метод:
GET
Запрос
http://<servername>/local/<appname>/.api?export-json[&date=<date>][&res=<res>]

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Описания запрошенных параметров
ПараметрОписание
<date>дата в виде ГГГГММДД
интервал дат в виде ГГГГММДД-ГГГГММДД
даты, разделенные запятыми, в виде ГГГГММДД,[..],ГГГГММДД
все (по умолчанию) для всех доступных данных
<res>15 мин (по умолчанию) для данных в 15-минутных ячейках
1 ч для данных в 1-часовых ячейках
24 ч для данных в суточных ячейках

Возвращаемое значение

Этот скрипт возвращает данные в формате JSON.

Очистить результаты подсчета

Формат:
обычный текст
Метод:
GET
Запрос
http://<servername>/local/<appname>/.apioperator?clear-data

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Возвращаемое значение
ОК

Сведения о живом просмотре

Возвращается информация о расположении строк в режиме живого просмотра.

Формат:
JSON
Метод:
GET
Запрос
http://<servername>/local/<appname>/.api?cntpos.json

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Ответ
{
  "width":<width>,
  "height":<height>,
  "left":<left>,
  "right":<right>,
  "top":<top>,
  "bottom":<bottom>,
  "yfirst":<yfirst>,
  "ylast":<ylast>,
  "radius":<radius>
}
Описания возвращаемых значений
ЗначениеОписание
<width>размер видеопотока
<height>
<left>х-координаты в пикселях для синих линий начала и окончания подсчета в режиме живого просмотра
<right>
<top>y-координаты y в пикселях для двух синих линий в режиме живого просмотра
<bottom>
<yfirst>y-координаты в пикселях для верхней и нижней части красной зоны подсчета без учета кривизны
<ylast>
<radius>радиус в пикселях, описывающий кривизну красной зоны подсчета (радиус измеряется от центра этой зоны по обеим осям) или указание на отсутствие кривизны границ зоны подсчета

Просмотр журнала системных событий

Формат:
обычный текст
Метод:
GET
Запрос
http://<servername>/local/<appname>/.apioperator?show-logs

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector

Возвращаемое значение

Отображаются журналы системных событий.

Создание архива журнала

Формат:
tar.gz
Метод:
GET
Запрос
http://<servername>/local/<appname>/.apioperator?generate-logs

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector

Возвращаемое значение

Архив журнала

Список параметров счетчика AXIS People Counter

Формат:
JSON
Метод:
GET
Запрос
http://<servername>/local/<appname>/.api?params.json

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector

Возвращаемое значение

Объект JSON из всех параметров, связанных со счетчиком AXIS People Counter.

Задание параметров счетчика AXIS People Counter

Формат:
текст
Метод:
POST

В формате post должны быть указаны пары и значения, и это лучше всего проиллюстрировать примером: &p1=Counter.Enable&v1=1&p2=Counter.Height&v2=280&setparams=needstobeincluded

Примечание.

Для встроенного ПО версии 5.60 и выше используйте: setparams&counter.Height=280, вместо указанного выше.

Запрос
http://<servername>/local/<appname>/.apioperator?setparams

Значение <appname> задает приложение согласно приведенной таблице.

ЗначениеПриложение
people-counterAXIS People Counter
occupancy-estimatorAXIS Occupancy Estimator
direction-detectorAXIS Direction Detector
tailgating-detectorAXIS Tailgating Detector
random-selectorAXIS Random Selector
Возвращаемое значение
ОК