Перейти в хранилище документации
Обратиться в техническую поддержку
Page History
GET http://IP-адрес:порт/префикс/archive/events/detectors/{ENDTIME}/{BEGINTIME} – получение сработок событий от детекторов со всех Серверов домена.
| Note | ||
|---|---|---|
| ||
|
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 | Нет |
|
| limit_to_archive | Нет | Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива). |
| archive | Нет | Имя архива из запроса получения списка архивов (см. Получение содержания архивов). |
| detector | Нет | Получение сработок событий от конкретного детектора. Список значений параметра detector приведен ниже в таблице. |
Примеры запросов:
- 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 – получить сработки
- события всех лучей с Server1. Максимальное количество по каждому лучу – 5.
- http://127.0.0.1:80/archive/events/detectors/A-ZHUKOV/DeviceIpint.1/SourceEndpoint.video:0:0/future/past?limit=100&detector=hosts/Server1/AVDetector.1/EventSupplier – получить сработки
- события от конкретного детектора с Server1.
- http://root:root@127.0.0.1:80/archive/events/detectors/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20230323T112000.000/20230430T210000.000?limit=100&offset=0&type=listed_face_detected,MotionDetected – получить сработки о
- события от нескольких детекторов с Server1. Детекторы необходимо перечислить через запятую.
- http://127.0.0.1:80/archive/events/detectors/past/future?limit=1&type=Ray – получить текущее состояние всех лучей домена.
| Note | ||
|---|---|---|
| ||
Рекомендуется использовать параметр past/future только в первом запросе. Затем следует получить timestamp самой последней записи и использовать его для запрашивания последующих записей. Использование параметра past/future вместе с параметрами limit и offset в последующих запросах может привести к возникновению дубликатов записей. |
Примеры ответа:
| Expand | ||||
|---|---|---|---|---|
1) join=1
2) join=0
|
| 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"
}
} |
При запросе сработок детектора событий от детекторов распознавания номеров в ответе будет дополнительный параметр plate, который будет содержать распознанный номер транспортного средства в формате Unicode.
| Code Block |
|---|
{
"alertState" : "happened",
"id" : "f1f334a3-3fb3-4770-80bf-c6519240b5cf",
"origin" : "hosts/Server1/AVDetector.1/EventSupplier",
"plate" : "\u0412427\u0412\u041c99",
"rectangles" :
[
{
"bottom" : 0.70833333333333337,
"index" : 0,
"left" : 0.4597222222222222,
"right" : 0.67222222222222228,
"top" : 0.64409722222222221
}
],
"source" : "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
"timestamp" : "20230725T140945.208000",
"type" : "plateRecognized"
} |
Возможные значения параметра type:
| Детектор | type |
| Трекер объектов или Нейротрекер | - |
| Пересечение линии | oneLine |
| Движение в области | moveInZone |
| Остановка в области | stopInZone |
| Вход в область | comeInZone |
| Выход из области | outOfZone |
| Длительное пребывание в области | longInZone |
| Множество объектов | lostObject |
| Детектор распознавания номеров | plateRecognized |
| Детектор распознавания номеров (распознавание номера из списка) | listed_lpr_detected |
| Детектор лиц | faceAppeared |
| Детектор лиц (распознавание лица из списка) | listed_face_detected |
| Подсчет посетителей | PeopleIn, PeopleOut |
| Детектор очереди | QueueDetected |
| Детектор огня | FireDetected |
| Детектор дыма | SmokeDetected |
| Нейросчетчик | lotsObjects |
| Изменение положения | SceneChangeDetected |
| Деградация качества | CameraBlindDetected |
| Детектор зашумления изображения | ImageDegradation |
| Детектор размытого изображения | BlurredDegradation |
| Детектор артефактов сжатия | CompressedDegradation |
| Детектор движения | MotionDetected |
| Отсутствие звука | NullAudio |
| Детектор сигнала | SignalAudio |
| Детектор шума | NoiseAudio |
| Детектор позы | - |
| Детектор лежащего человека | recumbent |
| Детектор сидящего человека | sitDown |
| Детектор поднятых рук | handsUp |
| Детектор стрелка | activeShooter |
| Детектор уровня воды | LevelOut |
| Детектор держания за поручень | handRail |
| Счетчик людей | lotsObjects |
| Детектор близко стоящих людей | peopleDistance |
| Маскирование людей | enabledMaskEvents |
Возможные значения параметра detector:
| detector | Детектор |
| SceneDescription | Трекер объектов или Нейротрекер |
| CrossOneLine | Пересечение линии |
| moveInZone | Движение в области |
| StopInZone | Остановка в области |
| ComeInZone | Вход в область |
| OutOfZone | Выход из области |
| LongInZone | Длительное пребывание в области |
| lostObject | Множество объектов |
| LprDetector | Детектор распознавания номеров |
| TvaFaceDetector | Детектор лиц |
| PeopleCounter | Подсчет посетителей |
| QueueDetector | Детектор очереди |
| FireDetector | Детектор огня |
| SmokeDetector | Детектор дыма |
| NeuroCounter | Нейросчетчик |
| SceneChange | Изменение положения |
| QualityDegradation | Деградация качества |
| QualityDegradation_v2 | Детектор зашумления изображения |
| BlurredDegradation | Детектор размытого изображения |
| CompressedDegradation | Детектор артефактов сжатия |
| MotionDetection | Детектор движения |
| NullAudioDetection | Отсутствие звука |
| SignalAudioDetection | Детектор сигнала |
| NoiseAudioDetection | Детектор шума |
| PoseDetector | Детектор позы |
| RecumbentDetector | Детектор лежащего человека |
| SitDownDetector | Детектор сидящего человека |
| HandsUpDetector | Детектор поднятых рук |
| ActiveShooterDetector | Детектор стрелка |
| WaterLevelDetector | Детектор уровня воды |
| HandRailDetector | Детектор держания за поручень |
| PeopleCountDetectorBySkeleton | Счетчик людей |
| PeopleDistanceDetector | Детектор близко стоящих людей |
| PoseMaskingDetector | Маскирование людей |
| Note | ||
|---|---|---|
| ||
|
Overview
Content Tools