Geofences can be downloaded directly from Telematics Guru onto supported devices, allowing for a wide range of new applications, including:
- Setting custom speed limits on private property, such as a mine site, and triggering a buzzer when the driver exceeds the limit. See example set up HERE
- Disabling cellular communication (and GPS fixes for a period of time) in a sensitive area, such as at an airport, or on an oil rig.
- Using alternate logging parameters to increase battery life
- Turning on a vehicle's emergency lights in a specific area.
For basic geofence settings, such as creating geofences and setting entry/exit alerts, please see the article here. Simply generating entry/exit alerts does not require the 'download to device' functionality to be configured.
Check the product datasheet (available on digitalmatter.com) to see if a particular product supports Geofence Downloads. Most of our cellular range does.
TABLE OF CONTENTS
- OEM Server System Parameters
- Telematics Guru: Enabling Geofence Downloads
- Geofence Asset Types
- Additional Geofence settings
- WiFi Positioning and Geofence downloads on the Falcon
OEM Server System Parameters
- First the device must be configured to download the Geofence via OEM:
- Edit the Admin Parameters of the device and add the "Geofence Server" tab.
- Ensure your device has the correct firmware version.
- Change the "Geofence Download Server" to your custom Telematics Guru URL and click Update.
If you're not sure of your URL, you can see it in Telematics Guru >> Admin >> Url Manager.
Once the device has checked into OEM server and downloaded the new parameters, the 'Admin' tag in 'Pending Updates' column with disappear.
Telematics Guru: Enabling Geofence Downloads
While creating your asset from new, or editing an existing asset;
- From Assets->Manage Assets, and click on the Asset name, or the cog menu on the right and select 'Edit'.
- Since Geo-fence download parameters are grouped by 'Asset Type' in the General Tab of the Edit Asset screen you can set the desired asset type.
Then select the 'Advanced' tab and Tick "Enable Geo-Fence Download" on the Edit Asset screen, this gets the device to look for the Geofence download from OEM
Geofence Asset Types
The Geofence downloads are grouped by asset type, allowing for intelligent management, and fast application of this feature. The process for configuring a Geofence download for an asset type is as follows:
Navigate to Admin->Asset Type Geo-Fences and select the desired asset type. (An individual 'Asset Type' is created in Admin > Asset Types, and assigned in Assets > Asset Manage)
- Click "Create Geofence Asset Type Setting"
- Select a Geofence to download and edit the desired fields. Not all features are available on all devices (for example, the Oyster does not have outputs, and so the 'Digital Output Settings' will have no effect).
- Click save, and repeat for each Geofence to download
Additional Geofence settings
- Speed Settings
- The minimum and maximum speed can be set for the geofence, and the device can be configured to buzz if its speed is not between the limits, alerting the driver that they must either speed up or slow down, depending on the situation. This buzzing option is only available on devices with either an internal buzzer, or digital outputs that have been configured to act as a buzzer, like the G100.
The speeds can also be used to override the speed limits on Telematics Guru if the "Override Speed Limit" checkbox is ticked. If so, then Telematics Guru will use these speeds in the speed banding calculations (TG Pro required). For further information click on the following link: Speed Monitoring in Telematics Guru.
- Upload Settings
- The moment a device recognises it has entered or exited a Geofence (dependant on the logging parameters), it can be configured to upload, which in turn could be used to trigger an alert (either an SMS or email). For information on how to set an alert on Telematics Guru, please consult: Configuring an Alert
- Digital Output Settings
- Digital outputs can be set based on whether a device is inside, or outside specific Geofences. This could be useful if you wanted to turn on a vehicle's emergency lights in a designated area.
- Digital outputs must be set system parameters via OEM server so that their function is "Digital Output" for this to work.
- This feature will only take effect if digital outputs are supported by the device. If you are unsure, please consult the relevant device datasheet.
- Communication Settings
- If the device gets a GPS fix inside a no communications Geofence, then it will not use cellular communications until it gets a GPS fix outside the fence. If the duration is not set, or set to 0, then the device will operate normally with trip tracking and periodic GPS fixes, with the exception that it will not attempt an upload.
- If the duration is set to anything other than 0, then the device will not attempt any GPS fixes or any uploads. It will go to sleep and not monitor anything until the time period expires. Once the timer has expired, the device will attempt to get a GPS fix. If it is still inside the fence or the fix fails, it will sleep for the same period of time, otherwise, if it is outside, the device will continue as normal.
- Alternate Logging (OEM server)
- If this is set, the device will use the alternate set of geofence logging system parameters configured on OEM. This can be used to intelligently manage the battery life of a device.
How many Geo-Fences can the device handle?
The limitation is on the device, and related to available RAM.
|Device Name||Max Geofences||Max Points/Geofence|
|Falcon||HW rev 1 - 20|
HW rev 3/4 - 100
|HW rev 1 - 20|
HW rev 3/4 - 100
Note these are absolute maximums of each.
There is a relationship between the average number of points in all geofences and the maximum number. If you have less points per geofence, you will be able to store more geofences. If you have a high number, you won't be able to reach the absolute max number of geofences. To reach the max, go with simple geofences - i.e. squares, 4 points.
- A spreadsheet is attached including a calculator showing the relationship.
How do you tell which version of the Geofence is downloaded?
In OEM Server, Access the details page of the device by clicking on the link on the left hand side of the device grid
Then scroll down until you see the device slots:
The version number that is displayed is an encoded date time, which you can use the calculator here to decode. In this case, 217919263 comes out to: 2019-11-28T05:07:43.000Z
When you have one Geofence inside another, which takes priority?
Geo Fences with a Higher priority are shown preference over those with a Lower priority. Where two Geo-Fences overlap with the same priority, the fence with the smallest area will be shown preference.
What triggers an update of the Geofence List?
If you add a geo-fence, edit a geo-fence or change a geo-fence asset type setting, it will result in the geo-fence list being updated. Once the geo-fence list has been updated, when the device next connects it will receive a message that will indicate to the device that it needs to download a new geo-fence list. The time it takes to update the device is dependent on when the device next connects after the geo-fence list has been updated.
WiFi Positioning and Geofence downloads on the Falcon
When a device is set to use WiFi scanning to get a position, the device does not actually know where it is, rather, after it sends the scan data up to the server, the server works this out. This effects the functionality of Geofences in relation to switching parameters when identifying they're inside or outside the Geofence. For this reason Geofence downloads is not available on the Yabby-Wifi, as this is impractical.
If you have a Falcon. that runs on GPS positioning until it enters a Geofence where it changes parameters to WiFi positioning via the OEM geofence advanced parameters, until this device fails a WiFi scan and changes back to GPS, it will not recognise it is still inside, or has moved outside of the Geofence.