Documentation

Managing Geofences

Geofences are custom map areas — polygons or lines — that NexaBus uses to detect when a vehicle enters or exits a specific zone. Unlike Stops, which are always simple circles tied to passenger pickup/drop-off, Geofences can be any shape and are meant for broader monitoring: restricted zones, service areas, speed zones, and similar use cases.

Accessing Geofences

Geofences has its own entry in the left-hand navigation menu, under the Transportation section.

Viewing Geofences

The Geofences table displays the following columns:

• ID: Unique identifier (hidden by default)
• Name: Geofence name
• Description: Optional description
• Shape: Polygon, Line, or Circle
• Sync Status: Connection status with visual indicators

On mobile devices, columns like ID, Description, Shape, and Sync Status are automatically hidden for better readability.

Searching for Geofences

Use the search field to find geofences. The search works across name and description fields. Results update as you type.

Customizing Columns

1. Click the Columns button above the table.
2. Check or uncheck columns to show or hide them.

Adding a Geofence

1. Click the Add Geofence button.
2. Complete the two tabs:

General Tab

• Name (Required): A descriptive name for the geofence (e.g., "Downtown Restricted Zone")
• Description (Optional): Additional information about the geofence
• Map: Draw the shape (see below)

Drawing the Shape

The map includes a drawing toolbar in the top-left corner:

• Polygon tool: Click to place each corner of the shape, then click the first point again (or double-click) to close it.
• Line tool: Click to place each point along the line, then double-click to finish.
• Trash tool: Deletes the current shape so you can redraw it.

The map also includes a search box and a "use my location" button in the top-right, so you can quickly jump to the area you want to draw in.

Once a shape is drawn:

• A confirmation message appears and the map's hint text updates to reflect that a shape is ready.
• The Create Geofence button is disabled until a shape exists.
• You can drag any point on the shape to adjust it, or use the trash tool and draw again.

Details Tab

All fields here are optional and control how the geofence is drawn on the map:

• Color: Pick a color for the shape's outline and fill. Defaults to blue if not set.
• Line Width: Thickness of the outline in pixels. Default: 2.
• Line Opacity: Transparency of the outline, from 0 (fully transparent) to 1 (fully opaque). Default: 1.
• Speed Limit: An informational speed limit associated with this zone.
• Floor / Ceiling: Altitude range, for geofences that apply to a specific building floor or elevation band.
• Hide from map: When enabled, the geofence is excluded from the live Tracking page map (it still exists and still generates enter/exit events — it just isn't drawn).

3. Click Create Geofence.

Editing a Geofence

1. Find the geofence in the table.
2. Click the actions menu (three dots) in that row.
3. Select Edit.
4. The map automatically zooms to the existing shape. Adjust the shape, name, description, or Details tab fields as needed.
5. Click Update Geofence.

Viewing a Geofence

1. Find the geofence in the table.
2. Click the actions menu (three dots) in that row.
3. Select View.

This opens a read-only map showing the geofence's shape, color, and line styling.

Deleting a Geofence

1. Find the geofence in the table.
2. Click the actions menu (three dots) in that row.
3. Select Delete.
4. Confirm the deletion.

Understanding Sync Status

Geofences sync with the tracking server in real-time:

• Syncing: Spinning icon indicates sync in progress (yellow)
• Synced: Check icon confirms successful synchronization (green)
• Failed: Error icon indicates sync failed - click to retry (red)

Sync status updates automatically without refreshing the page.

Retry Sync

If a geofence shows "Failed" status:

1. Click the sync status button, or
2. Open the actions menu and select Retry Sync

The geofence will attempt to sync again with the tracking server.

Linking Geofences to Devices and Groups

Beyond the geofence itself, you can control which devices or device groups are associated with it:

• When adding or editing a Device, use the Geofences field in the Details tab to select one or more geofences.
• When adding or editing a Group, use the Geofences field to link geofences to every device in that group.

This determines which vehicles' movements are checked against the geofence for enter/exit events.

Geofences on the Tracking Map

Geofences (aside from any marked "Hide from map") appear as shaded shapes with their name labeled on the live Tracking page map, using the same color and line styling configured in the Details tab.

Pagination

The table displays 10 geofences per page. Use the pagination controls at the bottom to navigate:

• First and Last page buttons
• Previous and Next page buttons
• Current page indicator showing "Showing X to Y of Z"

Permissions

You need the appropriate permissions to add, edit, or delete geofences:

• Create: Requires geofence:create permission
• View: Requires geofence:view permission
• Edit: Requires geofence:update permission
• Delete: Requires geofence:delete permission

If these options are not visible, contact your administrator to request access.