Introduction

The Vehicle Surveillance Package (VSP) is an add-on package on the Eagle Eye Cloud VMS that allows users to view, monitor, and analyze vehicle data.

The VSP stores license plates and other vehicle-related information from multiple locations and cameras. Users can search for a vehicle of interest using a specific plate search, or search using other vehicle categories such as Make, Color, Direction, and Body Type.

The VSP also analyzes the plate against configured rules to raise a real-time alert when a vehicle of interest is detected on any of the cameras.

Prerequisites

🚧

Important

VSP is a subscription added on a per-camera basis that can be enabled for cameras that already have LPR analytics enabled. (Eagle Eye LPR or On-Camera LPR Enabled on specific model numbers)

You need to meet the following requirements:

• You have a VSP subscription (EN(i)-PA-001-X)
• The camera you want to enable VSP on has LPR analytics enabled
• VSP is integrated with specific LPR analytics and the following LPR analytics:
  • Eagle Eye LPR (part Number EN(i)-ANA-020-X and EN(i)-ANA-022-X)
  • Hanwha LPR Models:
    • XNO-6120R/XNV-6120R with Arteco LPR Application
    • PNV-A9081RLP/PNO-A9081RLP with LPR pre-installed from Hanwha
• Users have permission to VSP

Events

VSP Summary /lprEvents:Summary

The VSP Summary shows the camera-level event count summary for the last hour, yesterday, today, the last 7 days, and the last 30 days.

The event count can be presented for the whole account, and also listed per cameras.

VSP Search /lprEvents

The API allows to search for vehicle events based on license plate, or using other vehicle categories like Make, Color, Direction, and Body types, and also based on user-defined data.

The search can defined by a set of cameras or locations, and also by a defined time range.

Rules /lprAlertConditionRules

The VSP rules service allows users to configure a rule and receive an alert when a license plate event qualifies the rule. There are different rules.

Eagle Eye VSP is configured to a specific plate or to a vehicle list (a group of license plates). It supports different rules, such as:

• Allowed Vehicle
• Denied Vehicle
• Watch Vehicle
• Hotlist

After the alert is generated, it is sent to the alert manager service, and the action is performed as it was configured for the rule. Through alert manager integration, VSP supports different alert actions, such as notifications though the web application or email, messages over Slack, as I/O triggers, and so on.

For the functionality of rules and their parameters to be configured, and example use cases see the following sections.

Allowed Vehicle (lprRuleAccessControlAllow)

Allowed Vehicle rules are configured to receive an alert for a specific plate, or for all plates in a vehicle list that has an access category as allow.

The configured rule can be mapped to a specific plate (RuleMapPlate) or to a specific vehicle list (RuleMapList).

Denied Vehicle (lprRuleAccessControlDeny)

Denied Vehicle rules are configured to receive an alert for a specific plate or for all plates in a vehicle list that has an access category as deny.

The configured rule can be mapped to a specific plate (RuleMapPlate) or to a specific vehicle list (RuleMapList).

Example: It is possible to deny entry to a parking area for a car whose permit has expired, and receive a notification upon its arrival.

Watch Vehicle (lprRuleWatch)

Watch Vehicle is a timebound rule that allows users to track vehicles against a defined time. The Watch Vehicle rule is configured to track vehicles between two vehicle events (between an origin camera and a destination camera which can be the same). A timer is configured and if the vehicle is not detected by the destination camera at the end of the timer, a watch alert is raised.

The Watch Vehicle rule can be configured for a specific plate, a vehicle in a specific vehicle list, or for all vehicles passing between the origin camera and destination camera. Exemptions to tracking could be made if a vehicle in the vehicle list has Vehicle Category (Security Status) marked as exempt.

Example:

• Parking: Track a vehicle between an entry and an exit and generate an alert if the parking exceeds the allowed time.
• Logistics/Warehouse: Track vehicles between an entry and an exit, and to track if the vehicle is inside a warehouse for more than the defined time.
• Car Service Center: Track vehicles taken out for a test drive and confirm if the vehicle is returned within a specific time window.

Hotlist Vehicle (lprRuleHotlist)

Hotlist Vehicle rules are configured to receive an alert for a specific plate, or for all plates in a vehicle list that has Vehicle Category (Security Status) marked as hotlist.

The configured rule can be mapped to a specific plate (RuleMapPlate) or to a specific vehicle list (RuleMapList).

Example:

• A multifamily home/HOA: Receive an alert for a payment defaulter as they enter the premises to take action.
• Clubs/Retails/Hospitality: The hotlist can be configured for VIP customers to generate an alert upon their arrival so they can be greeted at the entrance.
• Rental Car/Parking/Dumping Yard: Generate alerts for vehicles that are missing or had been reported as stolen when they appear on the premises.

Number of License Plate Events (lprRuleCountAggr)

The Number of License Plate Events rule is used for monitoring the camera /LPR settings to help alert users in case of any concerns. The Number of License Plate Events rule is configured to be generate alerts if the number of events is greater or lesser than a defined count in a specified time range.

Example: A low number of events might be due to a misaligned or out of focus camera. This rule can generate alerts if the event count goes lower than expected.

VSP Vehicle List /lprVehicleLists

Vehicle List is a group of plates grouped together under a single name for easy management. The vehicle list has an access category and access control schedule for LPR-based access control automation which is integrated with Eagle Eye LPR (with Local ID).

The Vehicle List can be integrated with an external database for its automatic update and management

The Vehicle List allows users to group vehicles under a list and map to specific cameras and locations.

For each vehicle the following information is provided: