You can map where an asset (or multiple assets) has driven for a given period of time, seeing the route it took and the events it triggered. Mapping asset history has been moved back to the Tracking screen (as it was in legacy iOn).

Note: You also can track the past 24 hours of historical data for up to 40 assets on the map using the History layer. (See Mapping Recent and Live Basic Asset Activity Using the History Layer for details.)

To view the history of one or more assets' activity, follow these steps:


  1. Click  on the left side of the screen.
     
    The Tracking screen will open and display the assets of the group you have selected in the Group Chooser.
     
    Note: Instead of performing steps 2 through 5, you can search for a single asset by typing part of its name in the Search field at the top left of the screen and selecting it from the matching entities that will appear in a drop-down list. Then skip down to step 6. Be aware, however, that the Search feature is somewhat buggy and doesn't always find all the matching assets.
     
    If you want to select your assets using one of the filters, click the filter's drop-down arrow, select the entities to use to limit your results, click Done, and then skip down to step 6. (See Saving an Asset or Geofence View as a Filter for more details about the filters.) 
  2. Click the Groups/Assets drop-down arrow at the top of the screen.
     
    Your selected group will be displayed (City of Meryton in the example in the following figure). It should be automatically expanded to show its subgroups. (If not, an expansion arrow will appear to the left of its name.)
    Note: If you need to map the history of assets that are in a group above this group, you'll need to change the group you have chosen in the Group Chooser, as shown in Choosing a Group to View Globally. If the assets are in a group that is above your assigned group in your account hierarchy, you'll need to obtain different permissions from your organization's software administrator.
     
  3. If the groups or assets you are mapping history for are subgroups or in subgroups, click the expansion arrow of the parent group ().
     
    If you need assets in one or more of their subgroups, click  to the left of the higher-level group's name — and keep doing so down the hierarchy until you reach the groups you want.
     
  4. To map history for entire groups, select the groups' check boxes. ( means selected, and  deselected.)
     
    To map history for individual assets, click the More Options () icon under the group they belong to.
     
    The group's assets will be displayed.
      
    Then select each asset's check box.
    Note: You can choose single assets under different groups as well.
    Caution: The number of assets times the number of days cannot exceed 40 (so you could return the history for 40 assets for one day, or 20 assets for two days).
  5. Click Done.
     
    The map will display only the assets you selected.
      
  6. Click the Dates drop-down arrow in the filters at the top of the page.
     
    Time period options will appear.
      
  7. To choose one of the common time frames, click the radio button for Today, Yesterday, Last 7 Days, or Last 30 Days and skip down to step 10. (Live indicates that you are currently tracking the assets' present activity.)
     
    To select specific dates, click Custom.
     
    Calendars for the current and following months will appear. (If your window width is smaller, you may see only the current month.)
      
  8. To select the first date, you can click the day on this month's calendar; click until you find the correct month and then select the day on its calendar; or type the date in the top field on the left (in the format mm/dd/yyyy hh:mm Xm), such as "03/30/2023 12:00 am."
     
  9. To select the end date, you can click the day on this month's calendar or type the date in the second field on the left (in the format mm/dd/yyyy hh:mm Xm), such as "04/08/2023 11:59 pm."
    Caution: The maximum number of days you can include in the range is 40.
  10. Click Done.
     
    The history of activity for the time range you selected will be displayed on the map at the top of the screen, and the data for the events will appear in a grid on the bottom, separated by asset.
     
    Note: If you need more screen real estate for either the grid or map, you can click and drag the tab separating the two up or down.
    Each asset's path line on the map will have its own color to help differentiate it from the others.
     
  11. Click the expansion arrow () for an individual asset to see its trips.
    Note: When the CalAmp application groups the results by trip, it calculates the trip separation from Ignition On to Ignition Off event.
     
    How many events are included in each trip will be shown in the Events column.

    When you select a single asset, the map will zoom in on just its path line.
     
  12. You can expand a trip to view all its individual events. The events will be listed in chronological order, with the oldest on top.
      
    You can scroll down if needed to see all the trip's events.
     
    The map displays circle indicators at the beginning and end of each trip on the path lines.
     
  13. If needed, you can scroll right at the bottom of the grid to see more of its columns.
    Note: Alternatively, you can place your cursor over the grid, press Shift, and scroll your mouse wheel to view columns to the right or left.
  14. You can select a trip or event in the grid to view it in particular on the map.
     
    The map will zoom in on it, that trip path line will remain its original color, and the remainder of the path line will become gray.
     
    Note: If you see in the Events column (such as ) for a trip, that indicates that a harsh event occurred. When you expand it, you'll see the event name in red.
     
    You can select the event's row in the grid to view the incident on the map, including a pop-up with the event name, date and time it occurred, location, and speed the asset was traveling at the time.
     
  15. You can zoom in or out on the map using or in the toolbar at the top right, respectively.
     
  16. If you want to specify only certain events to include in the results, follow these steps:
     
    1. In the grid, click the Events filter icon ().
       
      The filter will show the available events; by default, they all will be selected.
        
    2. Deselect the check boxes of the events you don't want to include. (Alternatively, you can deselect the [Select All] option and then check the ones you need.) ( means selected, and  deselected.)
      Note: You can type search criteria in the Search bar to have only certain events listed in the filter (such as "igniti" to show only Ignition Off and Ignition On).
    3. Click anywhere outside of the filter to close it.
       
      Only the events you specified will be included in the results. (The tiles above the grid will still show summary data for all the events, if you have them displayed.)
       
  17. By default, there will be tiles (called summary cards) above the grid with this possible information:
     
    Note: You can choose which of these are displayed or hide them altogether; see step 17 below.
    • Distance Traveled: The total miles or kilometers (depending on your default unit of measure) the assets drove in the selected time period.
       
    • Idling Time: The number of minutes the assets idled during that period.
       
    • Driving Time: The number of hours the assets traveled in the time range.
       
    • Harsh Events: The total count of harsh events (harsh braking, harsh acceleration, and harsh turning, plus speeding) the assets triggered over the course of the date range.
       
    • Assets: The asset count for the history.
       
  1. To configure which cards are shown or whether any are displayed at all (such as if you need more vertical space for the grid data), you can change certain settings as follows:
    Note: Any changes you make to your Asset History settings will persist across sessions; for example, if you deselect Show Summary Cards and log out, when you log back in, you'll see that the summary cards above the Asset History grid are still hidden.
    1. Click  at the top right of the grid.
       
      The Settings dialog box will appear.
        
    2. To hide all the summary cards, deselect Show Summary Cards.
       
    3. To hide an individual summary card (such as Distance Traveled), deselect its check box.
       
    4. If you find that there are events between the trips (which are figured from Ignition On to Ignition Off), you can select Show Events Between Trips (under Show Trips) to display those.
       
    5. You can change the default view of grouping the historical events by trips by deselecting Show Trips. If this is turned off, all the events will just be listed in chronological order.
       
    6. Click Done.
       
  2. To map asset history in only a certain geographic region (sometimes called a boundary search), perform the steps in Mapping Asset History in a Certain Area.
     
  3. You can export the grid information to a CSV (comma-separated value) file by clicking  at the top right of the data pane.
     
  4. You can add or remove grid columns by clicking to the right of and following the steps in Customizing Displayed Columns.
     
  5. If you don't have CalAmp save grid modifications you make automatically for all the application’s screens (if the Automatically Save Grid Settings toggle in the Preferences area of My Profile is deselected — see Viewing Your Profile and Setting Your Preferences), you can save any layout changes you've made to the Asset History grid by clicking . (If you haven't made any layout updates you can save, will be above the grid instead.) See Saving Grid Changes for an Individual Screen for more details.
     
  6. You can return to tracking the assets live by clicking Live View at the top left of the grid pane.

Note: You can view a history replay of an asset's activity (a step-by-step review of its past events) by clicking in the toolbar at the top right. See Viewing a History Replay for more details.