Typy zapytań i ich parametry

Obiekty w strefie (queryType="zone")

figures/shape to parametr wymagany. Określa strefę, w której obiekty mają się znajdować jako lista wierzchołków poligonowych. Koordynaty są ustalane jako ułamki wysokości/szerokości klatki (od 0 do 1). Nie pozwala na powiązanie z rozdzielczością określonej kamery.

Najprostsze zapytanie wygląda następująco:

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

Strefa opisuje prostokąt w centrum pola widzenia kamery.

queryProperties/action to opcjonalny parametr dla zapytania:

• Jeśli parametr nie został ustalony, obiekty w strefie są wyszukiwane.
• queryProperties/action="enter" - obiekty wchodzące do strefy są wyszukiwane.
• queryProperties/action="exit" - obiekty opuszczające strefę są wyszukiwane.

Przykład zapytania o obiekty wchodzące do strefy:

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

Ruch obiektów ze strefy do strefy(queryType="transition")

Istnieje jeden wymagany parametr dla tego typu wyszukiwania — figures. Musi on wyznaczać dwie strefy oznaczające strefę startową oraz strefę końcową.

Nie ma dodatkowych parametrów.

Wyszukiwanie obiektów, które przechodzą z lewej strony ramki do prawej strony ramki:

 {
    "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]
            ]
        }
    ]
}

Przekraczanie linii (queryType="line")

Wymagany parametr figures określa przekroczenie segmentu wyzwalającego warunek. Segment ten jest wyznaczany za pomocą dwóch linii.

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

Opcjonalny parametr queryProperties/direction umożliwia na określenie kierunku przekroczenia linii.

• Jeśli parametr ten nie jest skonfigurowany, obiekty przekraczające linię w dowolnym kierunku są wyszukiwane.
• queryProperties/direction="left" oznacza wyszukiwanie obiektów przekraczających linię z prawej do lewej z perspektywy prawego punktu segmentu.
• queryProperties/direction="right" oznacza wyszukiwanie obiektów przekraczających linię z lewej do prawej z perspektywy prawego punktu segmentu.

.

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