diff --git a/docs/docs/configuration/zones.md b/docs/docs/configuration/zones.md index 1d1e66c27..8dd63f0f3 100644 --- a/docs/docs/configuration/zones.md +++ b/docs/docs/configuration/zones.md @@ -157,8 +157,8 @@ The average speed of your object as it moved through your zone is saved in Friga #### Best practices and caveats -- Speed estimation works best with a straight road or path when your object travels in a straight line across that path. If your object makes turns, speed estimation may not be accurate. -- Create a zone where the bottom center of your object's bounding box travels directly through it and does not become obscured at any time. +- Speed estimation works best with a straight road or path when your object travels in a straight line across that path. Avoid creating your zone near intersections or anywhere that objects would make a turn. If the bounding box changes shape (either because the object made a turn or became partially obscured, for example), speed estimation will not be accurate. +- Create a zone where the bottom center of your object's bounding box travels directly through it and does not become obscured at any time. See the photo example above. - Depending on the size and location of your zone, you may want to decrease the zone's `inertia` value from the default of 3. - The more accurate your real-world dimensions can be measured, the more accurate speed estimation will be. However, due to the way Frigate's tracking algorithm works, you may need to tweak the real-world distance values so that estimated speeds better match real-world speeds. - Once an object leaves the zone, speed accuracy will likely decrease due to perspective distortion and misalignment with the calibrated area. Therefore, speed values will show as a zero through MQTT and will not be visible on the debug view when an object is outside of a speed tracking zone.