Go to documentation repository
...
Section | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Additional conditions match all kinds of requests. Conditions are always joined with logical “AND”. For instance, the “object of height not more than a quarter of the frame that is in the camera field of view for 5 seconds” request looks like this:추가 조건은 모든 종류의 요청에 적용됩니다. 조건은 항상 논리적 "AND"로 결합됩니다. 예를 들어, "카메라 시야에 5초 동안 존재하는 프레임의 4분의 1보다 큰 높이를 가진 객체" 요청은 다음과 같습니다.
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "objectProperties": { "size": { "height": [0, 0.25] } }, "conditions": { "duration": 5 } } |
...
objectProperties/category
)An object can be abandoned or moving (face, human, group, vehicle). In the request abandoned type cannot be mixed with other object types (otherwise the abandoned requirement will be ignored).
객체는 버려지거나 이동 중일 수 있습니다 (얼굴, 인간, 그룹, 차량). 요청에서 버려진 유형은 다른 객체 유형과 혼합될 수 없습니다 (그렇지 않으면 버려진 조건이 무시됩니다).
프레임의 어떤 지점에서든 버려진 객체를 검색하는 요청은 다음과 같습니다.Search for objects abandoned in any point of the frame looks like this:
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0, 0], [1, 0], [1, 1], [0, 1] ] } ], "objectProperties": { "category": ["abandoned"], } } |
The search for a human or a small group of people crossing the line looks like this:선을 넘어가는 사람이나 그룹을 검색하는 요청은 다음과 같습니다.
Code Block |
---|
{ "queryType": "line", "figures": [ { "shape": [ [0.5, 0.8], [0.5, 0.2] ] } ] "objectProperties": { "category": ["human", "group"], } } |
...
objectProperties/size
)It sets minimum and maximum width and height of an object객체의 최소 및 최대 너비와 높이를 설정합니다.
Note | ||
---|---|---|
| ||
The minimal values must be strictly less that 1, the maximum values must be strictly greater than 0. | ||
최소값은 반드시 1보다 작아야 하고 최대값은 반드시 0보다 커야 합니다. |
예를 들어, 프레임 높이의 4분의 1보다 크지 않은 객체를 찾으려면 다음 요청을 사용할 수 있습니다.For instance, to find objects that are not bigger than a quarter of the frame in height one can use this request:
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "objectProperties": { "size": { "width": [0, 1], "height": [0, 0.25] } } } } |
양쪽 치수를 모두 설정할 필요는 없으므로 이 요청은 이전 요청과 유사합니다.As both dimensions are not necessary to be set, this request will be similar to the previous one:
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "objectProperties": { "size": { "height": [0, 0.25] } } } |
...
objectProperties/color
)It sets minimum and maximum coordinates of the object color in HSV space. Hue is measured in degrees (from 0 to 360), saturation and brightness – in fractions from 0 to 1.
HSV 공간에서 객체 색상의 최소 및 최대 좌표를 설정합니다. 색상(Hue)은 0도에서 360도까지의 각도로 측정됩니다. 채도(Saturation)와 밝기(Brightness)는 0에서 1까지의 비율로 표현됩니다.
예를 들어, 영역 내에서 밝은 녹색 객체를 찾으려면 다음과 같은 요청을 사용할 수 있습니다.The request to get bright green objects in the zone looks like this:
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "objectProperties": { "color": { "hue": [75, 135], "saturation": [0.5, 1], "brightness": [0.5, 1] } } } |
In HSV space dark almost black colors can have any hue and saturation. So to search black objects the request should look like this:HSV 공간에서 어두운 거의 검은 색상은 어떤 색상(Hue)과 채도(Saturation)도 가질 수 있습니다. 따라서 검은 객체를 검색하려면 요청은 다음과 같이 작성해야 합니다.
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "objectProperties": { "color": { "hue": [0, 360], "saturation": [0, 1], "brightness": [0, 0.2] } } } |
Here is the same request for white objects:흰색 객체에 대한 요청은 다음과 같습니다.
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "objectProperties": { "color": { "hue": [0, 360], "saturation": [0, 0.1], "brightness": [0.8, 1] } } } |
...
conditions/velocity
)It sets minimum and maximum velocity of the object.
객체의 최소 및 최대 속도를 설정합니다.
속도는 초당 프레임 비율로 측정됩니다. 예를 들어, 객체가 1초 동안 프레임의 왼쪽 끝에서 오른쪽 끝으로 이동하는 속도는 1로 표시됩니다It is measured in frame rates per second – i.e. the velocity of the object moving from the left edge of the frame to the right one over 1 second is 1.
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "conditions": { "velocity": [0.25, 1] } } |
...
conditions/directions
)...
객체의 방향을 각도의 배열로 설정합니다.
각도는 라디안 단위로 측정되며, 오른쪽으로 향하는 축을 기준으로 시계 방향으로 계산됩니다. 예를 들어, 오른쪽으로 ±45° 범위로 이동하는 객체를 검색하려면 요청은 다음과 같이 작성됩니다.
It sets the direction for the object as an array of angles. Angles are measured in radians and are counted from the axis directed to the right clockwise.
So the request to get objects moving to the right ±45° looks like this:
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "conditions": { "directions": [ [315, 45] ] } } |
Pay attention that 45° − 315° angle covers all directions except “to the right”.각도는 "오른쪽" 방향을 제외한 모든 방향을 포함합니다.
객체가 주로 수평으로 이동하는 것을 찾으려면 두 개의 각도를 설정해야 합니다.If one needs to find objects moving mainly horizontally, then two angles are to be set:
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "conditions": { "directions": [ [315, 45], [135, 225] ] } } |
...
conditions/duration
)It sets time (in seconds) during which the object is to continuously meet all conditions.
객체가 모든 조건을 계속 충족해야 하는 시간을 초 단위로 설정합니다.
이 조건을 사용하면 "영역 내에서의 장시간 존재" 요청을 작성할 수 있습니다.Using this condition one can make the “long presence in the zone” request:
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "conditions": { "duration": 5 } } |
...
condtions/count
)It sets the minimum required number of objects that simultaneously meet other request conditions.
다른 요청 조건을 동시에 충족하는 최소 객체 수를 설정합니다.
보통은 영역 내에서 많은 수의 객체를 검색할 때 사용됩니다. 예It is usually used for search of a big number of objects in the zone. For instance:
Code Block |
---|
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "conditions": { "count": 3 } } |
...