Перейти в хранилище документации
Обратиться в техническую поддержку
Page History
| Section | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Общие сведения
- GET 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".
| Note | ||
|---|---|---|
| ||
Для корректной работы параметров detector, archive и limit_to_archive необходимо указывать {VIDEOSOURCEID} в адресе запроса. |
| Параметр | Обязательный | Описание |
|---|---|---|
| limit | Нет | Лимит событий от детекторов в ответе. Если не задан, по умолчанию 100 |
| offset | Нет | Смещение результатов выдачи на заданное число. Например, если запрос с offset=0 вернул 100 результатов, то для получения следующих необходимо выполнить запрос с offset=100. Если на второй запрос было возвращено 250 результатов, то для получения следующих требуется задать в запросе offset=350 и т.д. |
| type | Нет | Получение событий от детектора конкретного типа. Список возможных значений параметра type приведен ниже в таблице. Если необходимо получить события от нескольких типов, их необходимо перечислить через запятую |
| join | Нет |
|
| limit_to_archive | Нет | Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива) |
| archive | Нет | Имя архива из запроса получения списка архивов (см. Получение содержания архивов) |
| detector | Нет | Получение событий от конкретного детектора по определенной камерой. Для получения конкретного значения можно выполнить запрос Получение списка детекторов камеры. В результате после выполнения запроса значение для параметра detector будет указано в параметре name, например:
|
Примеры запросов
...
- 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/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 | ||
|---|---|---|
| ||
Рекомендуется использовать параметр past/future только в первом запросе. Затем следует получить timestamp самой последней записи и использовать его для запрашивания последующих записей. Использование параметра past/future вместе с параметрами limit и offset в последующих запросах может привести к возникновению дубликатов записей. |
...
Примеры ответов
| Expand | ||||
|---|---|---|---|---|
1) join=1
2) join=0
|
...
| Info | ||
|---|---|---|
| ||
|
При запросе событий от детектора очереди в ответе будет дополнительный параметр 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
...
| Note | ||
|---|---|---|
| ||
Возможные значения параметра type зависят от версии продукта и установленных детекторов. Для получения актуальных значений можно выполнить запрос получения списка детекторов по конкретной камере (см. Получение списка детекторов камеры). |
...
Overview
Content Tools