# Geofence The Geofence feature allows administrators to define virtual boundaries on the map and monitor when devices enter or exit those areas. The Companion App continuously tracks device location and reports geofence events to the Cubilock portal in real time.\ This feature helps organizations enforce location-based policies, track device compliance, and view detailed violation timelines. ## How to Setup Geofencing To start receiving geofence activity and geofence reports from devices, ensure the following prerequisites are met: 1. The latest Companion App is installed on the device. 2. Location permissions are fully granted to the Companion App (High-accuracy mode recommended). 3. The device has internet connectivity to sync geofence events with the server. 4. The geofence is created and assigned to the appropriate device(s) or profile(s) from the admin portal. Once these steps are complete, geofence monitoring begins automatically. ## Creating a Geofence Geofences can be created using two drawing tools: #### Polygon Geofence Select multiple points on the map to outline a custom-shaped area. #### Circular Geofence Click on the map to place the center point and specify a radius. As you draw, the system automatically calculates the total area of the geofence.
## Geofence Configuration After defining the boundary, configure the following: #### Basic Information * Geofence name
#### Scheduling Each geofence can be active for a specific time window.\ You can configure: * Start date * End date * Start time * End time
#### Limit to Specific Weekdays (Optional) Activate the geofence only on selected weekdays.\ If disabled, it operates every day between the configured date range.
#### Restrict to Specific Hours (Optional) Make the geofence active only within a defined time range on applicable days.
### Geofence Exit Actions When a device **exits** the defined geofence area, the system can automatically run one or more **Exit Actions**. These actions help you respond immediately if a device leaves an allowed zone. #### Where to find it Go to your geofence configuration screen and open: **Geofence Exit Actions → Select actions for devices outside geofence** #### How it works * Exit actions trigger **automatically** when the device transitions from **inside → outside** the geofence boundary. * You can enable **multiple actions** at the same time. * Actions apply to the device(s) assigned to that geofence policy. #### Available Exit Actions **Notify Admin** Sends an **email notification** to the admin when a device exits the geofence. **Use this when:** you want the operations/security team to be alerted immediately. *** **Lock Device** Locks the device (denies device access) as soon as it leaves the geofence. **Use this when:** devices must not be usable outside an approved location *** **Notify Device** Sends an **on-device notification** informing the user that the device has left the allowed area. **Use this when:** you want the user to self-correct (return to the allowed zone) before stricter actions are taken.
## Attach Devices A geofence must be applied to devices or device groups or to take effect.\ You can attach: * Profiles * Device Groups * Individual Devices Once assigned, devices immediately begin monitoring the defined boundaries.
## Viewing Geofences The Geofence overview page lists all configured geofences, along with: * Status (Active, Expired, Deactivated) * Compliance count * Violation count * Start and end dates Clicking a geofence displays its boundary on the map, along with associated device activity.
## Device Activity View The Device Activity View provides a detailed timeline of all geofence events recorded for a specific device. This view is useful for auditing movement patterns, understanding violation behavior, and validating whether devices are entering or exiting geofences according to schedule. When you open any device under a particular geofence, the system displays:
### Device Information Key identifiers for the selected device, including: * IMEI * Serial Number * Total violations recorded within the selected date range This ensures administrators can quickly verify the device being analyzed.
### Filters You can refine the activity results by adjusting: * **Start Date** * **End Date** Only events within the selected time window will be shown in the timeline and plotted on the map.
### Event Timeline The timeline presents a chronological sequence of all geofence-related activities for the device, grouped by date. Each entry includes: * The type of event (Entered or Exited the geofence) * Coordinates at the moment of the event * Exact timestamp * Highlighted color coding (e.g., red for Exited events) This allows administrators to immediately see when and how often the device crossed the geofence boundary.
### Map View Every event recorded in the timeline is simultaneously plotted on the map.\ The map provides: * Pinpointed location markers for each Enter and Exit event * A toggle for enabling or disabling the event markers * A clear visual overlay of the geofence boundary for contextual reference This combination of geographic visualization and event history enables accurate analysis of movement patterns and potential violations.
## Geofence & Compliance Reports A **violation** occurs when a device enters or exits a geofence outside the allowed schedule.\ A **Inside Geofence** event indicates the device is behaving within expected boundaries. The portal provides: * A chronological timeline of events (Enter, Exit) * Each event’s coordinates * Timestamp * Device details (Name, IMEI, Serial Number) You can also toggle the map event markers for better visualization. ## Filters Filters help you narrow down activity logs and geofence reports.\ Available filters include: * Date Range * Device * Profiles * Groups * Event Type (Enter, Exit)
## Geofence Report The Geofence Report screen shows aggregated geofence violations across all devices.\ You can view: * Device name * Serial number * Geofence name * Time of violation * Activity (Enter/Exit) * Coordinates * Actions Taken The report supports pagination and CSV download for external analysis.
*** ## Scheduled Reports You can configure automated email delivery for geofence reports.\ Scheduled reports help administrators receive timely compliance updates without logging in to the portal. *** ## Summary The Geofence feature provides complete visibility into device movement relative to defined boundaries. With flexible area drawing tools, scheduling, detailed violation logs, and automated reporting, administrators can easily monitor compliance and enforce location-based policies.