Перейти в хранилище документации
Обратиться в техническую поддержку![]()
GET http://IP-адрес:порт/префикс/archive/events/detectors/VIDEOSOURCEID/{ENDTIME}/BEGINTIME?limit=COUNT&offset=COUNT&join=COUNT&limit_to_archive=COUNT&archive=name - получение списка срабатываний детекторов.
В случае, если значение limit не указано, оно считается равным 100. offset - смещение на заданное количество сработок.
Поле timestamp не уникальное, поэтому, может понадобиться пропуск уже полученных ранее срабатываний детекторов от начала интервала поиска.
Если join=1, то в ответ будет выполняться склейка двухфазных событий и возвращаться параметр duration - длительность события.
Если join=0, то в ответе двухфазные события не будут склеиваться.
Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива).
archive - имя архива из запроса получения списка архивов (см. Получение содержания архивов).
| Info |
|---|
Параметры limit_to_archive и archive доступны, начиная с Axxon Next 4.4.1.9150. |
Примеры ответа:
{BEGINTIME} - получение сработок со всех Серверов Axxon-домена.
| Info | ||
|---|---|---|
| ||
Синтаксис ENDTIME и BEGINTIME описан в разделе Получение содержания архивов |
GET http://IP-адрес:порт/префикс/archive/events/detectors/{HOSTNAME}/{ENDTIME}/{BEGINTIME} - получение сработок с конкретного Сервера.
| Tip |
|---|
{HOSTNAME} - имя Сервера (см. Получение списка серверов). |
GET http://IP-адрес:порт/префикс/archive/events/detectors/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} - получение сработок с конкретной видеокамеры.
| Tip |
|---|
{VIDEOSOURCEID} - трехкомпонентный идентификатор endpoint-а источника (см. Получение списка источников видео (камер)). Например, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0". |
| Параметр | Обязательный | Описание |
|---|---|---|
| limit | Нет | Лимит сработок в ответе. Если не задан, по умолчанию 100. |
| offset | Нет | Смещение результатов выдачи на заданное число. Например, если запрос с offset=0 вернул 100 результатов, то для получения следующих необходимо выполнить запрос с offset=100. Если на второй запрос было возвращено 250 результатов, то для получения следующих требуется задать в запросе offset=350 и т.д. |
| type | Нет | Получение сработок конкретного детектора. Список значений параметра type приведен ниже в таблице. |
| join | Нет | Если join=1, то в ответ будет выполняться склейка двухфазных событий и возвращаться параметр duration - длительность события. Если join=0, то в ответе двухфазные события не будут склеиваться. |
| limit_to_archive | Нет | Доступен, начиная с Axxon Next 4.4.1.9150. Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива). |
| archive | Нет | Доступен, начиная с Axxon Next 4.4.1.9150. Имя архива из запроса получения списка архивов (см. Получение содержания архивов). |
Примеры запросов:
http://127.0.0.1:80/archive/events/detectors/Server1/DeviceIpint.2/SourceEndpoint.video:0:0/past/future?limit=10&offset=0 - получить сработки по указанной видеокамере, отсортированные по убыванию. Максимальное количество - 10.
http://127.0.0.1:80/archive/events/detectors/Server1/past/future?limit=5&offset=0 - получить сработки всех детекторов с Server1. Максимальное количество по каждому детектору - 5.
http://127.0.0.1:80/archive/events/detectors/Server1/past/future?limit=5&offset=0&type=Ray - получить сработки всех лучей c Server1. Максимальное количество по каждому лучу - 5.
http://127.0.0.1:80/archive/events/detectors/past/future?limit=1&type=Ray Получить текущее состояние всех лучей Axxon-домена.
Примеры ответа:
| Expand | ||||||
|---|---|---|---|---|---|---|
1) join=1
| ||||||
| Expand | ||||||
1) join=1
2) join=0
2) join=0
|
| Info | ||
|---|---|---|
| ||
Параметр multiPhaseSyncId будет в ответе только для двухфазных тревог с параметром alertState. |
...
– как обычно, трехкомпонентным, например - "HOST/DeviceIpint.2/SourceEndpoint.video:0:0";
– именем хоста, для получения событий с него;
– пустым, т.е. отсутствовать, для получения всех событий домена.
При запросе сработок детектора очереди в ответе будет дополнительный параметр extra, который будет содержать оценку длины очереди, выраженной минимальным и максимальным значением.
| Code Block | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{
|
...
|
| Note | ||
|---|---|---|
| ||
По умолчанию таймаут запроса - 10 секунд. Если Сервер за 10 секунд не успеет вернуть все события (количество задается параметром limit), ответ будет следующим:
В этом случае необходимо повторить запрос и уменьшить значение параметра limit. |
| Info | ||
|---|---|---|
| ||
Параметр multiPhaseSyncId будет в ответе только для двухфазных тревог с параметром alertState. Поле timestamp не уникальное, поэтому, может понадобиться пропуск уже полученных ранее срабатываний детекторов от начала интервала поиска. |
При запросе сработок детектора очереди в ответе будет дополнительный параметр extra, который будет содержать оценку длины очереди, выраженной минимальным и максимальным значением.
| Code Block |
|---|
{
"alertState": "happened",
"extra": [
{
"queueMax": "4"
},
{
"queueMin": "4"
}
],
"id": "b17129b2-1588-794b-94f6-d078a226efb2",
"origin": "hosts/Server1/AVDetector.4/EventSupplier",
"rectangles": [],
"source": "hosts/Server1/DeviceIpint.2/SourceEndpoint.video:0:0",
"timestamp": "20181206T075621.621000",
"type": "QueueDetected"
}
} |
Возможные значения параметра type:
| Детектор | type |
| Трекер объектов или Нейротрекер | - |
| Пересечение линии | oneLine |
| Движение в области | moveInZone |
| Остановка в области | stopInZone |
| Вход в область | comeInZone |
| Выход из области | outOfZone |
| Длительное пребывание в области | longInZone |
| Множество объектов | lostObject |
| Детектор распознавания номеров | plateRecognized |
| Детектор лиц | faceAppeared |
| Подсчет посетителей | PeopleIn, PeopleOut |
| Детектор очереди | QueueDetected |
| Детектор огня | FireDetected |
| Детектор дыма | SmokeDetected |
| Нейросчетчик | lotsObjects |
| Изменение положения | SceneChangeDetected |
| Деградация качества | CameraBlindDetected |
| Детектор зашумления изображения | ImageDegradation |
| Детектор размытого изображения | BlurredDegradation |
| Детектор артефактов сжатия | CompressedDegradation |
| Детектор движения | MotionDetected |
| Отсутствие звука | NullAudio |
| Детектор сигнала | SignalAudio |
| Детектор шума | NoiseAudio |
| Детектор позы | - |
| Детектор лежащего человека | recumbent |
| Детектор сидящего человека | sitDown |
| Детектор поднятых рук | handsUp |
| Детектор стрелка | activeShooter |
| Детектор уровня воды | LevelOut |
| Детектор держания за поручень | handRail |
| Счетчик людей | lotsObjects |
| Детектор близко стоящих людей | peopleDistance |
| Маскирование людей | enabledMaskEvents |
...
http://IP-адрес:порт/префикс/archive/events/detectors/HOST/DeviceIpint.2/SourceEndpoint.video:0:0/past/future?limit=10&offset=0 - получить сработки по указанной видеокамере, отсортированные по убыванию. Максимальное количество - 10.
http://IP-адрес:порт/префикс/archive/events/detectors/HOST/past/future?limit=5&offset=0 - получить сработки всех детекторов, созданных на машине HOST. Максимальное количество по каждому детектору - 5.
http://IP-адрес:порт/префикс/archive/events/detectors/HOST/past/future?limit=5&offset=0&type=Ray - получить сработки всех лучей, созданных на машине HOST. Максимальное количество по каждому лучу - 5.
http://IP-адрес:порт/префикс/archive/events/detectors/past/future?limit=1&type=Ray Получить текущее состояние всех лучей домена.
Возможные значения параметра type:
...
| Info | ||
|---|---|---|
| ||
Если было получено значение, не входящее в указанный список, значит это сработка встроенного детектора |
| Note | ||
|---|---|---|
| ||
Не гарантируется регистрозависимость типов сработок детекторов. Например, значения 'ComeInZone', 'comeInZone', 'COMEINZOne' следует рассматривать как одинаковые. |