Page History

Section

Column

width	35%

Panel

borderColor	#CCCCCC
bgColor	#FFFFFF
titleBGColor	#F0F0F0
borderStyle	solid
title	На странице:

Table of Contents

Column

Общие сведения

...

GET

http://IP-адрес:порт/префикс/archive/events/detectors/{ENDTIME}/{BEGINTIME} – получение

...

событий от детекторов со всех

...

серверов домена.

Note

title	Внимание!

Синтаксис ENDTIME и BEGINTIME описан в разделе Получение содержания архивов.
Если в запросе ENDTIME < BEGINTIME, то события в ответе будут отсортированы по возрастанию времени.
Если 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	Нет	Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива)

.


archive	Нет	Имя архива из запроса получения списка архивов (см. Получение содержания архивов)

.


detector	Нет	Получение

сработок

событий от конкретного детектора

. Список значений параметра detector приведен ниже в таблице.

Примеры запросов:

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

В результате после выполнения запроса значение для параметра detector будет указано в параметре name, например:

"name" : "hosts/SERVER/AVDetector.1/EventSupplier"

Note

title	Внимание!

Для корректной работы параметров detector, archive и limit_to_archive необходимо указывать {VIDEOSOURCEID} в адресе запроса.

Примеры запросов

http

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

Server1/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

title	Внимание!

Рекомендуется использовать параметр past/future только в первом запросе. Затем следует получить timestamp самой последней записи и использовать его для запрашивания последующих записей. Использование параметра past/future вместе с параметрами limit и offset в последующих запросах может привести к возникновению дубликатов записей.

Примеры ответов

Expand

1) join=1

Code Block

{
 "events": [
  {
   "duration": "000000.467000",
   "id": "09b8729a-a6fc-4ffa-8a83-aebc5c19d171",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.20831976890563964",
     "index": "0",
     "left": "0.57320795059204099",
     "right": "0.6804207420349121",
     "top": "0.09125151634216308"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T112815.527000",
   "type": "moveInZone"
  },
  {
   "duration": "000004.154000",
   "id": "90c5d09e-c0bb-4c49-bf8b-22d3afffe8c1",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.72451157569885249",
     "index": "0",
     "left": "0.092941055297851571",
     "right": "0.24284084320068361",
     "top": "0.4965816402435303"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T112814.426000",
   "type": "moveInZone"
  },
  {
   "duration": "000005.155000",
   "id": "dc953fad-bb08-4bae-bdce-62a09ab2dbd9",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.37916545867919921",
     "index": "0",
     "left": "0.10621988296508789",
     "right": "0.2311831474304199",
     "top": "0.11115360260009766"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T112814.293000",
   "type": "moveInZone"
  },
  {
   "duration": "000003.170000",
   "id": "f00875f0-bad7-4e74-879c-0a564baa9d36",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.2848846626281738",
     "index": "0",
     "left": "0.11811468601226806",
     "right": "0.18662774562835693",
     "top": "0.11245393753051756"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T112813.358000",
   "type": "moveInZone"
  }
 ],
 "more": true
}

2) join=0

Code Block

{
 "events": [
  {
   "alertState": "ended",
   "id": "cd3571bb-73c1-45cb-8965-a01e167836db",
   "multiPhaseSyncId": "6d72973d-7188-4fa7-9bf9-e3ba6013f2e3",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125142.417000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "310ce582-5f0d-4c27-a1d5-b14ccc5a877d",
   "multiPhaseSyncId": "6d72973d-7188-4fa7-9bf9-e3ba6013f2e3",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.46943313598632813",
     "index": "0",
     "left": "0.14642228603363036",
     "right": "0.23025640964508054",
     "top": "0.027766456604003897"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125142.200000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "aa193bbc-89e8-4204-8805-ac8c915b323c",
   "multiPhaseSyncId": "807248bf-4cee-431e-a29f-18ee0ed911ce",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.36835212707519532",
     "index": "0",
     "left": "0.072501201629638662",
     "right": "0.19335731506347656",
     "top": "0.03212909698486327"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125141.966000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "5b15234d-2a7f-415f-af57-2ac1ce5aa75a",
   "multiPhaseSyncId": "17fca913-f7a3-4f29-997f-d02a575d9fc4",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125136.978000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "48882f92-a809-424c-b7a7-55ac56b05061",
   "multiPhaseSyncId": "8bb9edbe-4391-4c26-8c7a-7faf620a62eb",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125136.661000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "6e98f979-c4f4-4c78-bbf4-6fc268219d79",
   "multiPhaseSyncId": "92534e2f-0f88-4698-a1a2-4e70d10cb00a",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125136.477000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "c9dff8bc-423b-414b-8dee-0a0b119a43df",
   "multiPhaseSyncId": "c8785151-f344-4c21-88de-6c339139afdf",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125135.843000",
   "type": "moveInZone"
  },
  {
   "alertState": "ended",
   "id": "db1f1147-ed50-46ff-84b7-8f06676d8f8e",
   "multiPhaseSyncId": "7eceb0b4-c04d-4e17-a405-3aff419fd94a",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125135.677000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "f9ccceda-9e16-4832-9f1f-1270fd0be365",
   "multiPhaseSyncId": "17fca913-f7a3-4f29-997f-d02a575d9fc4",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.30296741485595702",
     "index": "0",
     "left": "0.14849423646926879",
     "right": "0.21262614011764525",
     "top": "0.092105445861816404"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125135.677000",
   "type": "moveInZone"
  },
  {
   "alertState": "began",
   "id": "87ca4e1e-4a8c-433a-8b67-6e73f65fa0e2",
   "multiPhaseSyncId": "7eceb0b4-c04d-4e17-a405-3aff419fd94a",
   "origin": "hosts/Server1/AppDataDetector.1/EventSupplier",
   "rectangles": [
    {
     "bottom": "0.22597263336181642",
     "index": "0",
     "left": "0.080717468261718744",
     "right": "0.19577339172363281",
     "top": "0.014194698333740235"
    }
   ],
   "source": "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0",
   "timestamp": "20190618T125134.909000",
   "type": "moveInZone"
  }
 ],
 "more": true
}

Note

title	Внимание!

По умолчанию таймаут запроса – 10 секунд.

Если Сервер сервер за 10 секунд не успеет вернуть все события (количество задается параметром limit), ответ будет следующим:

Code Block
{ "events": [], "more": false }

В этом случае необходимо повторить запрос и уменьшить значение параметра limit.

Info

title	Примечание

Параметр 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:

...

NoiseAudio

...

При запросе событий от детекторов распознавания номеров в ответе будет дополнительный параметр 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

Note

title	Внимание!

Возможные значения параметра 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

title	Внимание!

Не гарантируется регистрозависимость типов

сработок

событий от детекторов. Например,

значения '

значения ComeInZone

'

,

'

comeInZone

'

,

'

COMEINZOne

'

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

сработка

событие от встроенного детектора.

Page tree

Versions Compared

Old Version 1

New Version Current

Key

Общие сведения

Примеры запросов

Примеры ответов

Возможные значения параметра type