Location History Investigation

This add-in shows which vehicles were inside an area you draw, over any date range up to 6 months. You can limit it to certain groups or vehicles, count only time when a plow, spreader, sander or sweeper was working, and replay each visit on a map.

Before you start

• Your user needs permission to add zones and rules, and to reprocess exceptions data. Ask your MyGeotab administrator if a submit fails with a permission error.
• Results are not instant. Short ranges usually finish within the hour; ranges over 7 days process overnight.
• Runs are shared: everyone who can open the add-in sees all runs and can clean them up.
• The map opens on the area where your vehicles are, then remembers where you left it.

Start an investigation

1. On the New investigation tab, enter a Run name you will recognize later.
2. Set the Date range. The start date can be up to 6 months back.
3. Type an address, intersection or place name in the search box above the map and press Enter, or zoom to the area yourself. Draw the area with the polygon or rectangle tool in the top left of the map.
4. Under Vehicles, choose All, Groups or Vehicles. For Groups or Vehicles, tick one or more from the list; type in the Filter box to find them quickly.
5. Optional: choose Equipment presets or Custom Aux inputs to count only time when that equipment was working.
6. Click Submit investigation.

Equipment options

With equipment selected, a visit only counts while the ignition is on and the equipment signal is active for more than 1 second. Several options count a visit when any of them is active.

Option	Counts time when
Plow	Aux 6 or Aux 7 is on, including third-party Aux 6/7 inputs
Spreader	The spreader controller reports status 4, 6 or 7, or Aux 8 is on
Sander	Aux 2 is on
Sweeper	Aux 3 is on
Custom Aux 1 to 8	The selected Aux input is on

These are the standard wiring defaults. If your vehicles are wired differently, use Custom Aux or ask Advantage One which inputs to choose.

Check progress

Open Recent runs and click Refresh. Processing means MyGeotab is still checking data, Ready means results are available, and No vehicle data means none of the vehicles had data in the range.

Review results and clean up

1. On a Ready run, click View results to see total visits, vehicles and time inside the area.
2. Each row shows the vehicle, when it entered and exited, and how long it stayed. Play replays the visit; Trips opens the vehicle's trips in MyGeotab.
3. Export CSV saves the visit list.
4. Clean up archives the rule and removes the zone the add-in created. Export first: results are no longer available afterward.

Replay a visit

Play shows the vehicle's path from 10 minutes before it entered to 10 minutes after it left. Grey is outside the visit, blue is inside, and orange is when the selected equipment was on. Click Play to animate or drag the slider; the time and speed show on the right.

Tips

• Keep date ranges and areas tight for faster, cleaner results.
• Zones and rules named PSI- belong to this add-in. Use Clean up rather than deleting them by hand.
• To change vehicles or equipment after submitting, submit a new run. Editing the rule in MyGeotab clears its results.
• If the page looks unstyled or blank, refresh without cache (Ctrl+Shift+R on Windows, Cmd+Option+R in Safari).
• Questions: contact Advantage One at shane@advtracking.net.