Ability to configure loitering time in a zone (#10543)

* Add loitering config

* Configure loitering

* simplify

* Add docs

* grammar

* Formatting

docs/docs/configuration/reference.md

@@ -488,6 +488,8 @@ cameras:
         coordinates: 545,1077,747,939,788,805
         # Optional: Number of consecutive frames required for object to be considered present in the zone (default: shown below).
         inertia: 3
+        # Optional: Number of seconds that an object must loiter to be considered in the zone (default: shown below)
+        loitering_time: 0
         # Optional: List of objects that can trigger this zone (default: all tracked objects)
         objects:
           - person

docs/docs/configuration/zones.md

@@ -60,6 +60,19 @@ camera:
 
 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.
 
+### Zone Loitering
+
+Sometimes objects are expected to be passing through a zone, but an object loitering in an area is unexpected. Zones can be configured to have a minimum loitering time before the object will be considered in the zone.
+
+```yaml
+camera:
+  zones:
+    sidewalk:
+      loitering_time: 4 # unit is in seconds
+      objects:
+        - person
+```
+
 ### Zone Inertia
 
 Sometimes an objects bounding box may be slightly incorrect and the bottom center of the bounding box is inside the zone while the object is not actually in the zone. Zone inertia helps guard against this by requiring an object's bounding box to be within the zone for multiple consecutive frames. This value can be configured: