> For the complete documentation index, see [llms.txt](https://help.solink.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.solink.com/docs/understand-your-business/ai-features/vision-analytics/zone-tracking-events.md). # Zone Tracking Events With Solink's Zone Tracking feature, automatically create an event whenever an individual in the camera view/vehicle remains in or leaves a zone for a certain period of time. **Note**: **Zone Tracking Events** are only available with a subscription to [**Vision Analytics**](https://solink.com/ai/vision-analytics/) (included in the Solink AI package). Unlike [**Zone Tracking Search**](/docs/understand-your-business/ai-features/vision-analytics/zone-tracking-search.md), you can create several zones - up to 5 per camera - and "set and forget" while Solink's AI generates events based on your configuration. Zone Tracking Events can help you track and measure: * Average speed of service. * Queue times that exceed X seconds. * Display effectiveness and product engagement. * No activity in a given area, such as the cash register or service counter. {% embed url="" %} *** ## How to Configure Zone Tracking Events **Note**: Ensure you have [enabled Vision Analytics](/docs/understand-your-business/ai-features/vision-analytics/enable-vision-analytics.md) on the camera you wish to configure Zone Tracking events for first. Select a camera on the **Video** page to start configuring Zone Tracking Events: 1. Select the **AI** button near the top-right of the video player. 2. Select **Zone Tracking:** 3. Select the **Events** tab in the Zone Tracking menu: ![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-fcf7f9d0295e1df97b8c79c16ccfb5af149a3a0a%2F61e9521528b780b3.png?alt=media) Next, you can add and draw a zone in the camera view - this zone can be configured to track queue time, dwell time, or when there is no activity present in the zone. To add a new zone: 1. Select the **Add** button in the top-right corner of the video player: 2. Draw a zone. Keep in mind what you want to track with your zone - follow these guidelines for an optimal zone: 1. **Queue times/speed of service**: Draw the zone around the customer queue area. 2. **Display effectiveness**: Draw the zone around the display area: 3. **No employee activity**: Draw the zone where an employee should be (cash register area): **Tip**: For faster AI performance, reduce the number of vertices in the zone. This may help if you are experiencing any issues with your events. 3. Next, configure the zone: 1. Type a **Name** for the zone. The name is recorded in the event card. 2. Select a zone **Type** (Queue, Dwell, or No Activity, as per the zone examples listed in step 2) Selecting the right type helps separate the zone data. 3. Set a **Minimum Time**. This determines the minimum time an individual must remain in the zone until an event is created. For a **No Activity** zone type, this instead creates an event when no one is present in the zone for the Minimum Time. ![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-6a203df51d423cb8cbf0063107fec77bf18a167e%2F1b8f46ec90dfa1b0.png?alt=media) 4. Select **Save** to apply the changes. For information on configuring an AI tag for the Service Display Monitor, see [this guide](/docs/understand-your-business/ai-features/service-display-monitor-getting-started/service-display-monitor-user-guide.md#assign-ai-tags). See [Locate Zone Tracking Events](#locate-zone-tracking-events) for help finding zone events. **Note**: It may take 30 seconds or longer from the time the event occurs to the time it displays on the Events page. **Note**: You can create up to 5 zones per camera. See the following sections for more information on the **Advanced Settings**. ### Drive-Off Detection You can enable drive-off detection for a vehicle tracking zone. See [Drive-Off Detection](/docs/understand-your-business/ai-features/vision-analytics/drive-off-detection.md) for more information. ### Track Single-Lane Vehicle Time You can measure the approximate vehicle journey time between one vehicle zone to another - for instance, the time it takes the vehicle to get through the drive-thru from the menu board to the window area. Toggle on the "Estimate single-lane total vehicle time" option and configure one zone as the "start zone" and one as the "end zone". Any events generated from the end zone are appended with **Total Journey Time**, as shown in the following image: **Note**: You can designate up to 2 start zones and 1 end zone. ### Track Zone Occupancy You can configure a zone to track and create an event when a maximum occupancy is reached. For instance, if you want to get notified when there are 5 or more people waiting in the queue line for 30 seconds or longer, you can create a zone in the queue area or revisit the existing zone and toggle on the "Track maximium occupancy" option: An event is then created whenever the maximum occupancy is met during the time you specify in seconds. See [Locate Zone Tracking Events](#locate-zone-tracking-events) for help finding zone events. *** ## Locate Zone Tracking Events You can locate all of your Zone Tracking events on the Events page in the Solink platform. To find your Zone Tracking events: 1. On the **Events** page, select the **AI** tab at the top of the page: 2. Select the **Zone Tracking** filter on the right-side of the page: Now, only Zone Tracking events are displayed on the page. ### Filter Zone Tracking Events You can use additional filters to narrow your search for Zone Tracking events. To get started: 1. Select the **Add Filter** button on the Events page. 2. Type "zone" in the search bar (or select All Categories > AI). 3. Select one of the following Zone Tracking filters to narrow your search: 1. **Zone Label**: The name assigned to the zone when you configured it in the Zone Tracking Events menu. 2. **Zone Time**: The time, in seconds, that one or more people/vehicles remained in the zone for (or for No Activity, this displays the Minimum Time configured for the zone). 3. **Zone Type**: Choose from a **Queue**, **Dwell** or **No Activity** zone type. ![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-64dfda84a3a857d05de921c4809727a312f0af38%2F8221a0e5ba9b9d73.png?alt=media) ### Highlight People/Vehicles in an Event You can highlight the associated people or vehicles in an event within the video player timeline (or hover over an event from the left side of the page). A "bounding box" displays in the video footage around the people/vehicles connected to the event: See [Highlight Objects](/docs/understand-your-business/ai-features/vision-analytics/highlight-people-and-vehicles-with-ai.md) for more information. *** ## Create Zone Tracking Report You can create a report that captures the **total number of times in a day that people/vehicles remained in the zone longer than X seconds** OR **total time spent in the zone** over a period of time (day, week, month, year). Then, use this report to create widgets for these use cases. **Note**: Please reach out to your Customer Success Representative if you require help creating a Zone Tracking report and widgets. To create this report: 1. Add filters on the Events page based on what you want the widget to display. For example, you may want to target a specific zone or all of your zones, therefore add filters that target either a specific Zone Label or Zone Type (e.g., Dwell). Please refer to [Filter Zone Tracking Events](#filter-zone-tracking-events) section for information on how to filter these events and refer to [Create a Report](/docs/understand-your-business/search-and-save-reports/create-a-report.md) for more information on creating reports. 2. Select the **Zone Time** filter and choose "is greater than" X seconds. For example, to capture only instances of people/vehicles in the zone(s) greater than 2 minutes, type "120" (seconds):\ ​ ![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-b1be2488dc5e641cb2b0b080fd6b0d8886f426a9%2F004463b68087501b.png?alt=media) Pictured below is an example of filters that will capture events with a specific Zone Type, Zone Label (name) and only if time spent in the zone was greater than 120 seconds: ### **Create Widget: Frequency Person Spent More than X** S**econds in Zone** Create a widget that displays the total number of times a person or people/vehicles remained in zone(s) for more than **X** seconds: On the **Dashboard** page, select **+Widget** to get started: 1. Select the **Report** widget type. 2. Select the report you created as outlined in the [previous section](#create-zone-tracking-report). 3. In the **Category** field, select **Other**. 4. In the **Data Type** field, select **All Event Types (Count)**. 5. In the **Statistic** field, select **Count**. ![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-9ebf5befae0273cfa4296e143c3b9ccf40b5f73e%2F8e2f108e7838f76d.png?alt=media) Configure the rest of the widget to your liking and use the Dashboard filters to manipulate the data displayed in the widget (show data based on location(s) and/or time period). **Note**: See our [Widget guides](/docs/understand-your-business/create-widgets.md) for more information on how to create and configure widgets. ### **Create Widget: Total Time Spent in Zone** Create a widget that displays the total time people/vehicles remained in the zone(s) during a given time period (day/week/month/year): On the **Dashboard** page, select **+Widget** to get started: 1. Select the **Report** widget type. 2. Select the report you created as outlined in the [previous section](#create-zone-tracking-report). 3. In the **Category** field, select **AI**. 4. In the **Data Type** field, select **Zone Time**. 5. In the **Statistic** field, select **Sum**. ![](https://1562067156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlMN1EUQcXYfv7FYpGJWR%2Fuploads%2Fgit-blob-e96c3681f13c5a9ca1945da4d88f7c6f4c0405c0%2F99cb27682a4e6b70.png?alt=media) Configure the rest of the widget to your liking and use the Dashboard filters to manipulate the data displayed in the widget (show data based on location(s) and/or time period). **Note**: See our [Widget guides](/docs/understand-your-business/create-widgets.md) for more information on how to create and configure widgets. --- # 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.solink.com/docs/understand-your-business/ai-features/vision-analytics/zone-tracking-events.md?ask=&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.