Go to documentation repository
Previous page Next page
추가 조건은 모든 종류의 요청에 적용됩니다. 조건은 항상 논리적 "AND"로 결합됩니다. 예를 들어, "카메라 시야에 5초 동안 존재하는 프레임의 4분의 1보다 큰 높이를 가진 객체" 요청은 다음과 같습니다.
{ "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
)객체는 버려지거나 이동 중일 수 있습니다 (얼굴, 인간, 그룹, 차량). 요청에서 버려진 유형은 다른 객체 유형과 혼합될 수 없습니다 (그렇지 않으면 버려진 조건이 무시됩니다).
프레임의 어떤 지점에서든 버려진 객체를 검색하는 요청은 다음과 같습니다.
{ "queryType": "zone", "figures": [ { "shape": [ [0, 0], [1, 0], [1, 1], [0, 1] ] } ], "objectProperties": { "category": ["abandoned"], } }
선을 넘어가는 사람이나 그룹을 검색하는 요청은 다음과 같습니다.
{ "queryType": "line", "figures": [ { "shape": [ [0.5, 0.8], [0.5, 0.2] ] } ] "objectProperties": { "category": ["human", "group"], } }
objectProperties/size
)객체의 최소 및 최대 너비와 높이를 설정합니다.
Attention!
최소값은 반드시 1보다 작아야 하고 최대값은 반드시 0보다 커야 합니다.
예를 들어, 프레임 높이의 4분의 1보다 크지 않은 객체를 찾으려면 다음 요청을 사용할 수 있습니다.
{ "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] } } }
양쪽 치수를 모두 설정할 필요는 없으므로 이 요청은 이전 요청과 유사합니다.
{ "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
)HSV 공간에서 객체 색상의 최소 및 최대 좌표를 설정합니다. 색상(Hue)은 0도에서 360도까지의 각도로 측정됩니다. 채도(Saturation)와 밝기(Brightness)는 0에서 1까지의 비율로 표현됩니다.
예를 들어, 영역 내에서 밝은 녹색 객체를 찾으려면 다음과 같은 요청을 사용할 수 있습니다.
{ "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] } } }
HSV 공간에서 어두운 거의 검은 색상은 어떤 색상(Hue)과 채도(Saturation)도 가질 수 있습니다. 따라서 검은 객체를 검색하려면 요청은 다음과 같이 작성해야 합니다.
{ "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] } } }
흰색 객체에 대한 요청은 다음과 같습니다.
{ "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
)객체의 최소 및 최대 속도를 설정합니다.
속도는 초당 프레임 비율로 측정됩니다. 예를 들어, 객체가 1초 동안 프레임의 왼쪽 끝에서 오른쪽 끝으로 이동하는 속도는 1로 표시됩니다.
{ "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° 범위로 이동하는 객체를 검색하려면 요청은 다음과 같이 작성됩니다.
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "conditions": { "directions": [ [315, 45] ] } }
45° − 315° 각도는 "오른쪽" 방향을 제외한 모든 방향을 포함합니다.
객체가 주로 수평으로 이동하는 것을 찾으려면 두 개의 각도를 설정해야 합니다.
{ "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
)객체가 모든 조건을 계속 충족해야 하는 시간을 초 단위로 설정합니다.
이 조건을 사용하면 "영역 내에서의 장시간 존재" 요청을 작성할 수 있습니다.
{ "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
)다른 요청 조건을 동시에 충족하는 최소 객체 수를 설정합니다.
보통은 영역 내에서 많은 수의 객체를 검색할 때 사용됩니다. 예:
{ "queryType": "zone", "figures": [ { "shape": [ [0.3, 0.3], [0.7, 0.3], [0.7, 0.7], [0.3, 0.7] ] } ], "conditions": { "count": 3 } }