Geofences | Overview
Introduction to Geofences
This page is for the Operations App. For the Classic Operations App please see Geofencing (Classic Operations App). Geofences require both XD 25.2.1+ and CXT Driver 3.7.3+ for full functionality.
Like most modules, users must have permissions enabled to see it. Go to the User’s Permissions > Maintenance Functions > Geofencing. See Users for more information on permissions.
Geofences are a radius in miles that you can set around locations, which can warn a driver if they try to complete their workflow outside of it, or can force the driver to be inside the Geofence radius before they are able to complete their workflow. A common use would be making sure a driver is at the actual delivery location before they can mark their cargo as ‘Delivered’.
When Geofences are set to Warn, for every driver status update outside the Geofence radius, a warning notifies the driver and dispatcher, and a Status Code is attached to the shipment (or Route Stop).
When Geofences are set to Enforce, the behavior is the same as Warn except the driver is also physically unable to complete their delivery workflow until they are back inside the Geofence radius.
Drivers have no override option for the Geofence Enforce setting in the CXT Driver App, so they will need to contact their dispatcher if their workflow is blocked and they believe a mistake has occurred. Please read this page in its entirety before deciding if the Geofence Enforce setting is right for your operations.
In order for both Warn and Enforce Geofences to apply Status Codes to driver status updates, you must enable “Outside Geofence” Status Code on customer records, for every customer you want Geofences to apply to. See section below on how to enable this. If this is not set up, Warn and Enforce will still notify drivers about workflow activity outside the Geofence radius but they will not log any Status Codes.
Feature Guide Video
Navigating to the Geofences Module
You can get started by going to the Maintenance tab in the sidebar >
Geofences.
Once you’re in the Geofences module, you can use the Search bar to look for specific Geofence records, narrowing the search by Type, ID, Geofence Radius (miles), Priority and more.
You can also use the icons in the top right to Edit Layout, swap to
Table View or swap to
Card View, respectively.
You can use either the Create New button in the top right corner to make a brand new Geofences record OR select an existing Geofences record for editing.
Creating and Editing a Geofence Record
Now that you have a Geofence record open, you can begin entering, or modifying, key information.
The first setting to configure is the Geofence Type, which determines what level the Geofence applies at.
Driver: the Geofence applies to all stops that driver does.
Customer: the Geofence applies to all stops for that customer.
Order Type: the Geofence will be applied to any on-demand shipments using that Order Type
Business Unit: the Geofence will apply to all stops for all customers in that Business Unit
Global: the Geofence applies to all stops
Select the target with the Type ID. For example, if you wanted to apply this Geofence to a specific customer, you would select the Customer Type and input their Customer ID (12345) as the Type ID. If you wanted to apply it to a specific driver, select Driver as the Type and input their Driver ID as the Type ID.
Next, the Geofence Radius (miles) will let you specify how large the Geofence circle is. You can use fractions of miles (0.25, 0.5, 0.75). It’s better to have a radius that is a little too big, rather than too small, as big Geofences can always be shrunken down later but Geofences that are too small could unintentionally disrupt a driver’s workflow.
Cached GPS Grace Time (Minutes) lets you specify a time extension for GPS pings inside the Geofence, from 0 to 60 minutes. Leave it at 0 for the most accurate Geofence behavior. To show drivers more grace, such as if they’re making a delivery at a large, complex site (like a hospital) or they will be inside a building that might disrupt GPS pings, you could increase it to 1-5 minutes.
Cached GPS Grace Time (Minutes) Example: if the time was set to 5 minutes, and a driver had a GPS ping from 2 minutes ago that was inside the Geofence, then the 2 minute ping would be counted as the driver being inside the Geofence. But if the time was set for 1 minute, then that GPS ping from 2 minutes ago would not be counted. This can be helpful for drivers if they are entering a building that they were able to get a Geofence ping outside of, but inside, they might not be able to generate GPS pings due to signal disruption.
As you configure Geofence Radius (miles) and Cached GPS Grace Time (Minutes), bear in mind the limitations of GPS technology. Concrete or underground structures, large sites and other signal disruptors can sometimes cause GPS pings to be off by 1-2 minutes or a half mile. CXT Software recommends erring on the side of caution with GPS-dependent Geofence parameters.
Priority determines which Geofence takes precedence where two or more could apply. Lower values indicate higher priority. If two applicable Geofences have the same priority, the one with the smaller Geofence radius will apply.
Last, use the Outside Geofence Enforcement setting to determine what category of Geofence this is, Ignore, Warn or Enforce.
Ignore: this is simply used to save a Geofence record and its settings but leave it in an inactive state; it can be reactivated any time by changing it to Warn or Enforce
Warn: for every driver status update outside the Geofence radius, a Status Code notifies both driver and dispatcher, and is attached to the shipment (or Route Stop)
Enforce: the behavior is the same as Warn except the driver is also physically unable to complete their delivery workflow in the app until they are back inside the Geofence radius
Once you’re finished configuring the Geofence settings, click on the save button in the bottom right corner.
Setting Up the "Outside Geofence" Status Code
In order for Warn and Enforce Geofences to log Status Codes whenever a driver status update occurs outside the Geofence, the customer in question needs to have the "Outside Geofence" Status Code enabled on their Customer record.
There are easy two ways you can add the “Outside Geofence” Status Code:
Enable “Outside Geofence” for all Customers
Enable “Ouside Geofence” on individual Customer records
You can also edit the “Outside Geofence” Status Code record to enable Mobile Display, which will allow drivers to see the Status Code, and Internet Display, which will allow your customers to see the “Outside Geofence” Status Code in the Client Portal whenever it is reported. Read on for more information.
Enable Geofencing for All Customers
Go to Maintenance > Status Codes.
Click the Enable All Customers icon for the “Outside Geofence” status code.
Enable Geofencing for Specific Customers
Go to Maintenance > Customers > Select the desired Customer record > navigate to the Status Codes work view.
Locate and tick the Outside Geofence Status Code
Click the
Save button.
Enable Drivers to Edit the "Outside Geofence" Status Code
When Mobile Display is enabled on the Outside Geofence Status Code record, drivers can see the “Outside Geofence” Status Code and edit its comments in the Driver App. When Mobile Display is disabled, drivers will not be able to see the "Outside Geofence" Status Code in the Driver App or edit its comments.
Enable Geofence Status Codes in the Client Portal
When Internet Display is enabled on the Outside Geofence Status Code record, Client Portal users can see the Status Code in the Track Order and Route Tracking sections of the Client Portal.
Your customers will see the Status Code represented like this:
Dependencies
A dependency refers to settings or modules outside of the primary module (in this case, Geofences) which affect the behavior of that module, are closely-related, or rely on it for their own function.
The most common location for dependencies are the Global Options menu and the Maintenance side tab. Any dependencies already covered on this page, as well as any others, are listed below:
Maintenance > Status Codes > “Outside Geofence” Default Code > Enable All Customers Button
Maintenance > Status Codes > “Outside Geofence” Default Code record > Mobile Display and Internet Display
Maintenance > Customers > Existing Customer Record or Create New > Status Codes Work View > “Outside Geofence” Checkbox
Maintenance > Drivers > Existing Driver Record or Create New > Mobile Options > Navigate Down to GPS Sync > Tick GPS Required Checkbox
Like many other features, Geofences require a validated Address with correct Latitude and Longitude to ensure proper function