Loitering Detection Configuration
Application Guide
For a complete walkthrough with code examples, see the Loitering Detection application guide.
GetSmartLoiteringConfig
Retrieves loitering detection configuration. Loitering detection triggers an alarm when a person or vehicle remains within a defined zone for longer than a configured time threshold.
| Field | Value |
|---|---|
| Endpoint | /GetSmartLoiteringConfig[/channelId] |
| Method | POST or GET |
| Products | IPC |
| Channel ID | Optional (default 1) |
Response
The response returns the loitering detection configuration in the standard <config> XML wrapper, including the detection zone, dwell time threshold, and object filter settings. Query this endpoint against your camera to see the full XML structure for your firmware version.
Notes
- Loitering detection combines zone-based detection with a time threshold — a target must remain in the zone for the configured duration before an alarm triggers.
- This is useful for detecting suspicious behavior such as someone lingering near a door, ATM, or restricted area.
- The corresponding Set command is
SetSmartLoiteringConfigusing the same XML structure returned by the Get command. - Loitering webhook events use
smartTypevalueLOITERING(IPC format) orloiterDetection(NVR format).
Related Endpoints
| Endpoint | Purpose |
|---|---|
| GetSmartPerimeterConfig | Intrusion detection (immediate trigger, no dwell time) |
| GetSmartAoiEntryConfig | Region entry detection |
| SetHttpPostConfig | Configure webhook destination for loitering alerts |