Geofences

A geofence is a named circular area on the map — a centre point and a radius in meters. Once you’ve drawn one, Wasp Asset can overlay it on the Asset Map, tell which assets’ GPS positions fall inside it, run an automatic action when an asset arrives, and raise a notification when an asset leaves. Typical geofences are a yard, a job site, a customer’s premises, or a depot.

Before you begin

• A Google Maps API key is required. Geofences, like every map feature, only appear once a valid key is saved under Settings → Options. See Asset Map for details.
• Creating, editing and deleting geofences needs the geofence permissions on your role — ask an administrator if the Geofences entry is missing from the Lookups menu.
• Geofences only do something for assets that have a GPS position: one entered on the asset’s Geo Location tab, captured during a transaction, or reported by a GPS tracker. An asset with no position is never inside any geofence.

Add or edit a geofence

1. Open Geofences from the Lookups menu to see your list.
2. Click New to create a geofence, or click an existing name to edit it.
3. Give it a Name (required, and unique) and an optional Description.
4. Set the area, either way:
   • Type an Address and click Find on Map to centre the circle there, or
   • enter a Latitude, Longitude and Radius (m) directly.
5. Fine-tune it on the map: drag the centre pin to move the circle, or resize the circle to change its radius. The radius must be greater than zero meters.
6. Click Save.

To remove geofences, select them in the list, click Delete, and confirm.

Note

A geofence is a boundary, not a location. Assets aren’t assigned to a geofence the way they’re assigned to a site and location; whether an asset is inside one is worked out from its latest GPS position each time that position changes.

See which assets are inside a geofence

Open Asset → Asset Map and turn on Show Geofences. Each geofence is drawn as a circle over the asset markers, so the markers inside a circle are the assets currently inside that geofence. Click a marker to see the asset’s details, and use the map’s filters to narrow by asset type or site.

An individual asset’s Geo Location tab shows that asset’s own position and history.

Geofence Auto-Actions

Geofence Auto-Actions let Wasp Asset act on its own when an asset enters a geofence. Open the page from the Geofences list (or from the Settings menu) and build a rule as a sentence:

When an asset enters the geofence Main Yard, Move it to Main Yard / Bay 3.

Each rule names one geofence and one of three actions:

• Move the asset to a location you pick.
• Check Out the asset to an employee, customer or vendor you pick.
• Check In the asset.

Each geofence can have one Move rule, one Check-Out rule and one Check-In rule. Delete a rule from the same page.

Note

Auto-actions fire only from GPS tracker updates, not from a position you type in by hand or one captured during a transaction. That keeps a manual edit from triggering a move or check-out nobody intended.

Be told when an asset leaves

Separately from auto-actions, Wasp Asset raises an Asset Left Geofence alert whenever an asset’s position moves from inside a geofence to outside it, from any source. Create a notification rule for it to be emailed or alerted in the app, and choose whether it applies to every geofence or one in particular.

Troubleshooting

• The Geofences menu is missing, or the map on the page won’t load. A valid Google Maps API key must be saved under Settings → Options, and your role needs the geofence permissions.
• “A geofence with this name already exists.” Names are unique; pick another or edit the existing one.
• An asset I expect inside a geofence doesn’t show there. The asset has no GPS position yet, or its latest position is outside the circle. Check its Geo Location tab, and compare the circle’s radius with the position’s accuracy.
• My auto-action didn’t fire. Auto-actions run only when a GPS tracker reports the asset entering the geofence, and only for the actions configured on that geofence. A hand-entered or transaction-captured position never triggers one.
• I can’t edit geofences. Creating and editing geofences needs the geofence permissions on your role — ask an administrator.

Related

• Asset Map — the fleet map geofences are drawn on, and how an asset gets a GPS position
• Notifications — the Asset Left Geofence alert
• Moving an asset and Checking out an asset — the actions a geofence can perform
• Sites & locations — where an asset is assigned, as opposed to where it is
• Lookups overview