Типы запросов и их параметры

Пребывание объекта в зоне (queryType="zone")

Обязательным параметром является figures/shape, который задает зону, в которой должен находится объект в виде списка вершин полигона. Координаты задаются в долях от ширины/высоты кадра (значения от 0 до 1). Начало координат в левом верхнем углу кадра. Первая координата в каждой паре отсчитывается по горизонтальной оси, а вторая – по вертикальной. Это позволяет не привязываться к конкретному разрешению видеокамеры.

Самый простой запрос выглядит следующим образом:

{
    "queryType": "zone",
    "figures": [
        {
            "shape": [
                [0.3, 0.3],
                [0.7, 0.3],
                [0.7, 0.7],
                [0.3, 0.7]
            ]
        }
    ]
}

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

Необязательным параметром запроса является queryProperties/action:

• Если этот параметр не задан, ищутся объекты находящиеся в зоне.
• При queryProperties/action="enter" ищутся объекты вошедшие в зону.
• При queryProperties/action="exit" ищутся объекты покинувшие в зону.

Пример запроса объектов вошедших в зону:

{
    "queryType": "zone",
    "figures": [
        {
            "shape": [
                [0.3, 0.3],
                [0.7, 0.3],
                [0.7, 0.7],
                [0.3, 0.7]
            ]
        }
    ],
    "queryProperties": {
        "action": "enter"
    }
}

Перемещение объекта из одной зоны в другую (queryType="transition")

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

Необязательных параметров нет.

Поиск объектов переместившихся из левой половины кадра в правую:

 {
    "queryType": "transition",
    "figures": [
        {
            "shape": [
                [0, 0],
                [0.45, 0],
                [0.45, 1],
                [0, 1]
            ]
        },
        {
            "shape": [
                [0.55, 0],
                [1, 0],
                [1, 1],
                [0.55, 1]
            ]
        }
    ]
}

Пересечение линии (queryType="line")

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

 {
    "queryType": "line",
    "figures": [
        {
            "shape": [
                [0.5, 0.8],
                [0.5, 0.2]
            ]
        }
    ]
}

Необязательный параметр queryProperties/direction задает направление пересечения линии.

• Если параметр не задан, в результаты попадут объекты пересекшие линию в любом направлении.
• queryProperties/direction="left" означает, что объект должен пересечь линию справа налево, если смотреть из первой точки отрезка.
• queryProperties/direction="right" означает, что объект должен пересечь линию слева направо, если смотреть из первой точки отрезка.

 {
    "queryType": "line",
    "figures": [
        {
            "shape": [
                [0.5, 0.8],
                [0.5, 0.2]
            ]
        }
    ],
    "queryProperties": {
        "direction": "left"
    }
}