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 violation 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.

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.

Violation & Compliance Reports

A violation occurs when a device enters or exits a geofence outside the allowed schedule. A compliant 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 violation reports. Available filters include:

• Date Range

• Device

• Profiles

• Groups

• Event Type (Enter, Exit)

Violation Report

The Violation 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

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.