mirror of
https://github.com/blakeblackshear/frigate.git
synced 2025-02-05 00:15:51 +01:00
41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
---
|
|
id: zones
|
|
title: Zones
|
|
---
|
|
|
|
Zones allow you to define a specific area of the frame and apply additional filters for object types so you can determine whether or not an object is within a particular area. Presence in a zone is evaluated based on the bottom center of the bounding box for the object. It does not matter how much of the bounding box overlaps with the zone.
|
|
|
|
Zones cannot have the same name as a camera. If desired, a single zone can include multiple cameras if you have multiple cameras covering the same area by configuring zones with the same name for each camera.
|
|
|
|
During testing, enable the Zones option for the debug feed so you can adjust as needed. The zone line will increase in thickness when any object enters the zone.
|
|
|
|
To create a zone, follow [the steps for a "Motion mask"](/configuration/masks), but use the section of the web UI for creating a zone instead.
|
|
|
|
### Restricting zones to specific objects
|
|
|
|
Sometimes you want to limit a zone to specific object types to have more granular control of when events/snapshots are saved. The following example will limit one zone to person objects and the other to cars.
|
|
|
|
```yaml
|
|
camera:
|
|
record:
|
|
events:
|
|
required_zones:
|
|
- entire_yard
|
|
- front_yard_street
|
|
snapshots:
|
|
required_zones:
|
|
- entire_yard
|
|
- front_yard_street
|
|
zones:
|
|
entire_yard:
|
|
coordinates: ... (everywhere you want a person)
|
|
objects:
|
|
- person
|
|
front_yard_street:
|
|
coordinates: ... (just the street)
|
|
objects:
|
|
- car
|
|
```
|
|
|
|
Only car objects can trigger the `front_yard_street` zone and only person can trigger the `entire_yard`. You will get events for person objects that enter anywhere in the yard, and events for cars only if they enter the street.
|