> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/verkada-cameras/ko/analytics/people-and-vehicle-motion-search.md).

# 사람 및 차량 움직임 검색

고급 움직임 검색으로 사람과 차량의 경로를 검색하는 방법을 알아보세요

Verkada의 사람 및 차량 검색 기능은 고급 컴퓨터 비전 기능을 사용하여 카메라 시야 내의 사람과 차량을 식별하고 관련 이벤트를 빠르게 찾습니다.

Verkada Command UI는 즉시 재생 미리보기와 이동 경로 보기를 지원합니다. 이동 경로 분석 기능은 이벤트 검색 가능성을 제공하여 누락된 탐지를 줄이고, 탐지 거리를 향상시키며, 중복을 줄입니다.

***

## 타임라인에서 사람과 차량 보기

{% hint style="danger" %}
보려면 Site Viewer 및 Site Admin 권한이 필요합니다 **모션** 카메라 피드 아래의 탭입니다. ...에 대해 자세히 알아보기 [카메라 역할 및 권한](/verkada-cameras/ko/getting-started/roles-and-permissions-for-cameras.md).
{% endhint %}

Verkada 카메라에서 감지된 사람과 차량은 기록 영상에서 볼 수 있습니다.

{% stepper %}
{% step %}
**Verkada Command에서 전체 제품 > 카메라로 이동합니다.**
{% endstep %}

{% step %}
**피드를 보려면 카메라를 선택하세요.**
{% endstep %}

{% step %}
**모션 탭을 선택하세요.**
{% endstep %}

{% step %}
**오른쪽에서 경로 표시를 클릭하여 기능을 켜거나 끕니다.**

아이콘이 검은색이면 기능이 켜진 것입니다.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-4d0f01e221068da46bbaff1cfc58af52334f4d5a%2F8213deb7340340cef96aec93b114a56b87d241df.png?alt=media" alt=""></div>

* 영상 피드를 클릭하고 드래그하여 해당 영역의 움직임을 검색할 격자를 만듭니다.
* 더 세분화된 검색을 위해 사람, 차량, 날짜 필터를 사용하세요.
  {% endstep %}

{% step %}
**사람 또는 차량 탭이 선택된 상태에서 썸네일에 마우스를 올리면 프레임 내 사람 또는 차량 수와 클립을 보관하는 옵션을 볼 수 있습니다.**

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-ceea3e7bef570b8b4de6b99e6bf22235cb167297%2F791d25868a560c579143c0c5cfe0df04f58aeaa5.png?alt=media" alt="" width="961"></div>

{% hint style="warning" %}
사람 및/또는 차량은 카메라 프레임에서 감지된 경우에만 사용할 수 있습니다.
{% endhint %}
{% endstep %}

{% step %}
**미리보기 위에 마우스를 올려 개별 추적 경로를 봅니다.**

<div align="left" data-with-frame="true"><figure><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2FByhX2qc4YvoUl2m7fcrc%2FScreenshot_2026-04-23_at_5_26_27%E2%80%AFPM.png?alt=media&amp;token=4964c115-a49e-42dc-ba90-46e01b7236df" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**썸네일을 클릭하면 녹화 영상의 정확한 시간으로 이동합니다.**
{% endstep %}
{% endstepper %}

### 사람 궤적(경로) 보기

사람 궤적 기능은 장면을 이동하는 사람의 경로를 시각화하여 각 감지된 사람의 궤적을 보여줍니다.

궤적은 모션 이벤트 재현율을 크게 향상시키고 카메라가 더 먼 거리의 사람과 차량을 인식할 수 있게 합니다. 각 모델의 탐지 범위를 자세히 보려면 [사람 분석 가이드](https://docs.verkada.com/docs/people-analytics-guide.pdf).

{% stepper %}
{% step %}
**Verkada Command에서 전체 제품 > 카메라로 이동합니다.**
{% endstep %}

{% step %}
**피드를 보려면 카메라를 선택하세요.**
{% endstep %}

{% step %}
**모션 탭을 선택하세요.**
{% endstep %}

{% step %}
**(선택 사항) 영상 플레이어 격자에서 선택하여 해당 영역의 움직임을 검색합니다.**
{% endstep %}

{% step %}
**궤적을 보려면 사람 또는 차량 필터를 선택하세요.**

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-75c82b4b7ff81a647ec3aa4f2e5573300a9bc2b1%2F56e59cc0f76fb1c39d44397671265680d5e9ac8f.png?alt=media" alt=""></div>
{% endstep %}
{% endstepper %}

### MotionX 고급 검색

Verkada는 특정 이벤트를 기반으로 한 고급 검색을 지원합니다. 필터를 사용하여 다음과 같은 사람 또는 차량 클립을 빠르게 검색할 수 있습니다:

* 특정 선을 통과한
* 프레임 내 최소 개수
* 최소 시간 동안 시야에 있었던

각 필터를 개별적으로 그리고 함께 어떻게 사용할 수 있는지 자세히 알아보려면 아래를 참조하세요.

#### 선 횡단 설정

{% hint style="warning" %}
전용 [CB53-E](https://docs.verkada.com/docs/video-security-cb53-e-datasheet.pdf)/[CB63-E](https://docs.verkada.com/docs/video-security-cb63-e-datasheet.pdf), [CB52-E/CB62-E](https://www.verkada.com/security-cameras/bullet#models), [CD22](https://www.verkada.com/au/security-cameras/dome/cd22/)/[CD22-E](https://www.verkada.com/au/security-cameras/dome/cd22-e/), [CD32](https://www.verkada.com/au/security-cameras/dome/cd32/)/[CD32-E](https://www.verkada.com/au/security-cameras/dome/cd32-e/), [CD42](https://www.verkada.com/security-cameras/dome/cd42/)/[CD42-E](https://www.verkada.com/security-cameras/dome/cd42-e/), [CD43](https://docs.verkada.com/docs/video-security-cd43-datasheet.pdf)/[CD43-E](https://docs.verkada.com/docs/video-security-cd43-e-datasheet.pdf), [CD52](https://www.verkada.com/security-cameras/dome/cd52/)/[CD52-E](https://www.verkada.com/security-cameras/bullet/cb52-e/), [CD53](https://docs.verkada.com/docs/video-security-cd53-datasheet.pdf)/[CD53-E](https://docs.verkada.com/docs/video-security-cd53-e-datasheet.pdf), [CD62](https://www.verkada.com/security-cameras/dome/cd62/)/[CD62-E](https://www.verkada.com/security-cameras/bullet/cb62-e/), [CD63](https://docs.verkada.com/docs/video-security-cd63-datasheet.pdf)/[CD63-E](https://docs.verkada.com/docs/video-security-cd63-e-datasheet.pdf), [CH52-E](https://www.verkada.com/security-cameras/multisensor/ch52-e/), [CH53-E](https://docs.verkada.com/docs/video-security-ch53-e-datasheet.pdf), [CH63-E](https://docs.verkada.com/docs/video-security-ch63-e-datasheet.pdf), [CM22](https://docs.verkada.com/docs/cm22-mini-dome-datasheet.pdf), [CM42](https://www.verkada.com/security-cameras/mini/cm42/), [CM42-S](https://www.verkada.com/security-cameras/mini/cm42-s/), [CR63-E](https://docs.verkada.com/docs/video-security-cr63-e-datasheet.pdf)/[CR63-TE](https://docs.verkada.com/docs/video-security-cr63-te-datasheet.pdf), [CY53-E](https://docs.verkada.com/docs/video-security-cy53-e-datasheet.pdf), 그리고 [CY63-E](https://docs.verkada.com/docs/video-security-cy63-e-datasheet.pdf) 카메라만 이 기능을 지원합니다.
{% endhint %}

{% stepper %}
{% step %}
**Verkada Command에서 전체 제품 > 카메라로 이동합니다.**
{% endstep %}

{% step %}
**카메라를 선택합니다.**
{% endstep %}

{% step %}
**오른쪽 메뉴에서 카메라 오버레이 > 선 횡단 검색을 클릭합니다.**
{% endstep %}

{% step %}
**선을 추가하려면:**

a. 실시간 피드를 클릭하여 선을 시작할 위치에 점을 놓습니다.\
b. 마우스를 드래그하고 선을 끝낼 지점을 클릭합니다.\
c. 선을 그린 후 방향을 선택합니다.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-37ae5f8a4e69e86b9cee761d08839d81ba3578b4%2F2ca7f6c735568f33e21989436bc2a80f2bfcfcc9.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**생성된 모션 썸네일에는 그려진 선을 통과한 감지된 객체가 표시됩니다.**

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-cba30d7002165b5bca9ba499b9757b72d332a6a8%2F3889a814b27692f5780beec875c23df2105a2246.png?alt=media" alt="" width="728"></div>
{% endstep %}
{% endstepper %}

#### 프레임 내 사람 수로 필터링

{% hint style="warning" %}
이 기능은 모든 카메라에서 사용할 수 있습니다.
{% endhint %}

{% stepper %}
{% step %}
**Verkada Command에서 전체 제품 > 카메라로 이동합니다.**
{% endstep %}

{% step %}
**카메라를 선택하여 모션 탭을 확인하세요.**
{% endstep %}

{% step %}
**사람 수 드롭다운에서 옵션을 선택하세요.**

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-94e2990edd7b5d9695088d17ffcb67aa2ab664a4%2Fd323800fc73bbfafe415ccb93b045141540f40cd.png?alt=media" alt=""></div>
{% endstep %}

{% step %}
**필터링된 결과에는 다음과 같은 경우의 썸네일이 표시됩니다&#x20;*****최소*****&#x20;선택한 사람 수가 프레임에 있습니다.**
{% endstep %}
{% endstepper %}

#### 사람/차량이 시야에 있었던 시간으로 필터링

{% hint style="warning" %}
전용 [CB53-E](https://docs.verkada.com/docs/video-security-cb53-e-datasheet.pdf)/[CB63-E](https://docs.verkada.com/docs/video-security-cb63-e-datasheet.pdf), [CB52-E/CB62-E](https://www.verkada.com/security-cameras/bullet#models), [CD22](https://www.verkada.com/au/security-cameras/dome/cd22/)/[CD22-E](https://www.verkada.com/au/security-cameras/dome/cd22-e/), [CD32](https://www.verkada.com/au/security-cameras/dome/cd32/)/[CD32-E](https://www.verkada.com/au/security-cameras/dome/cd32-e/), [CD42](https://www.verkada.com/security-cameras/dome/cd42/)/[CD42-E](https://www.verkada.com/security-cameras/dome/cd42-e/), [CD43](https://docs.verkada.com/docs/video-security-cd43-datasheet.pdf)/[CD43-E](https://docs.verkada.com/docs/video-security-cd43-e-datasheet.pdf), [CD52](https://www.verkada.com/security-cameras/dome/cd52/)/[CD52-E](https://www.verkada.com/security-cameras/bullet/cb52-e/), [CD53](https://docs.verkada.com/docs/video-security-cd53-datasheet.pdf)/[CD53-E](https://docs.verkada.com/docs/video-security-cd53-e-datasheet.pdf), [CD62](https://www.verkada.com/security-cameras/dome/cd62/)/[CD62-E](https://www.verkada.com/security-cameras/bullet/cb62-e/), [CD63](https://docs.verkada.com/docs/video-security-cd63-datasheet.pdf)/[CD63-E](https://docs.verkada.com/docs/video-security-cd63-e-datasheet.pdf), [CH52-E](https://www.verkada.com/security-cameras/multisensor/ch52-e/), [CH53-E](https://docs.verkada.com/docs/video-security-ch53-e-datasheet.pdf), [CH63-E](https://docs.verkada.com/docs/video-security-ch63-e-datasheet.pdf), [CM22](https://docs.verkada.com/docs/cm22-mini-dome-datasheet.pdf), [CM42](https://www.verkada.com/security-cameras/mini/cm42/), [CM42-S](https://www.verkada.com/security-cameras/mini/cm42-s/), [CR63-E](https://docs.verkada.com/docs/video-security-cr63-e-datasheet.pdf)/[CR63-TE](https://docs.verkada.com/docs/video-security-cr63-te-datasheet.pdf), [CY53-E](https://docs.verkada.com/docs/video-security-cy53-e-datasheet.pdf), 그리고 [CY63-E](https://docs.verkada.com/docs/video-security-cy63-e-datasheet.pdf) 카메라만 이 기능을 지원합니다.
{% endhint %}

{% stepper %}
{% step %}
**Verkada Command에서 전체 제품 > 카메라로 이동합니다.**
{% endstep %}

{% step %}
**카메라를 선택합니다.**
{% endstep %}

{% step %}
**모션 탭에서 오른쪽 상단의 시야 시간 드롭다운을 클릭하고 시간 범위를 선택하세요.**

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-123385aba3913e41adad7615bc7b73ba0d8b0df5%2F452a505e0a6efb2ac85abb9102e61f3b7e67c55f.png?alt=media" alt=""></div>
{% endstep %}

{% step %}
**필터링된 결과에는 다음 기간 동안 시야에 있었던 모든 일치 항목이 표시됩니다&#x20;*****최소*****&#x20;선택한 기간 동안.**
{% endstep %}
{% endstepper %}

{% hint style="info" %}
이러한 필터를 어떤 조합으로든 사용하면 논리적 AND 연산이 적용되어 모든 조건이 모든 썸네일에 대해 동시에 참이어야 합니다. 예를 들어 다음과 같이 설정한 경우:

* 카메라 오버레이에 선을 그렸습니다
* 선택됨 **사람 수: 3명 이상**
* 선택됨 **시야 시간: 10초**

결과는 최소 3명의 사람이 그 선을 교차하는 기록된 궤적을 가지고 있고, AND 최소 3명의 사람이 프레임에 있으며, AND 최소 3명의 사람이 최소 10초 동안 프레임에 있었던 경우로 필터링됩니다.
{% endhint %}

***

## 호환되는 카메라

다음 표는 어떤 카메라 모델이 모션 이벤트를 지원하는지, 어떤 모델이 모션 궤적을 지원하는지, 그리고 모션 모델이 어디에서 실행되는지를 설명합니다. 최신 카메라 모델은 모션 감지 모델을 로컬에서 실행할 수 있지만, D 시리즈 카메라는 여전히 이를 실행하기 위해 Verkada Cloud에 의존합니다.

|                                                                                                                                                                                          |            |           |            |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --------- | ---------- |
| **모델**                                                                                                                                                                                   | **모션 이벤트** | **모션 궤적** | **모션 모델**  |
| <p>CB53-E, CB63-E,</p><p>CB52-E, CB62-E, CD22, CD32, CD42, CD43, CD52, CD53, CD62, CD63, CF81-E, CF83-E, CH52, CH53, CH63, CM42, CM42-S, CP52-E, CP63-E, CR63-E, CR63-TE, CY53, CY63</p> | 지원됨        | 지원됨       | 카메라에서 실행됨  |
| CD31, CD41, CD51, CD61, CM41, CM61                                                                                                                                                       | 지원됨        | 지원되지 않음   | 카메라에서 실행됨  |
| D30, D40, D50, D80                                                                                                                                                                       | 지원됨        | 지원되지 않음   | 클라우드에서 실행됨 |

***

{% hint style="info" %}
**작동 모습을 보고 싶으신가요?** 다음 항목을 확인해 보세요. [동영상 튜토리얼](https://www.youtube.com/watch?v=H4f0hVifcWs\&list=PL3USUWfBbtdJpB2F8sOOJOdvv2qlWcfpk\&index=1).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.verkada.com/verkada-cameras/ko/analytics/people-and-vehicle-motion-search.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.