How to View Employee Location Tracking on a Map in Acumatica
How to View Employee Location Tracking on a Map in Acumatica
Location tracking in Acumatica is a powerful feature for field service businesses. When enabled, it allows managers and dispatchers to see where their staff members are in real time or where they’ve been throughout the day. But a common point of confusion arises when users check the location history and only see coordinates—longitude and latitude—without a map view.
If you've already enabled location tracking and are seeing raw data in the Location Tracking History screen, the good news is: a full map view is available—you just need to access it through the right screens and ensure the configuration is complete.
Viewing the Map
There are two main screens in Acumatica where you can visualize staff location tracking data:
- Staff Appointments on Map (FS301100)
This screen shows the live location of employees during their working hours. The location marker appears on the map and includes a tooltip with the employee ID and timestamp of the last recorded position. - Appointment History on Map (FS301200)
This screen lets you view the historical trajectory of an employee on a specific date. The system draws a green line on the map representing the path taken by the staff member throughout the day.
These tools provide both real-time visibility and historical tracking, which is especially useful for optimizing routes, verifying work hours, or improving customer service responsiveness.
How to Configure It Properly
To get this working, a few key configuration steps must be completed. Skipping any of them could result in missing map data or no location tracking at all.
- Enable Show Location Tracking in Service Management Preferences
Navigate to the Service Management Preferences screen (FS100100). Under the Calendars & Maps tab, enable the Show Location Tracking option. This activates map-based tracking features throughout the service screens. - Enter a Valid Bing Maps API Key
Acumatica relies on Bing Maps to render the map views. Make sure a valid Bing Maps API key is configured in your system preferences. Without it, the maps won’t display. - Enable Tracking for Users
Go to the Users screen (SM201010) and open the Location Tracking tab. Ensure that Track Location is enabled for each user you want to track. Also, make sure the tracking schedule (start and end times) is defined properly—location will only be recorded during those hours. - Enable GPS on Mobile Devices
The Acumatica mobile app must have GPS permissions enabled on each staff member’s device. If the phone doesn’t allow location access, the system cannot record or display the user's position. - Verify Employee Calendar
Check the user’s Employee Calendar to ensure it reflects the actual working hours. Location tracking is active only during scheduled working hours, so any mismatch in the calendar will result in gaps or missing data.
About the Location Tracking History Screen
The Location Tracking History screen (SM202000) is often where users first go to find tracking data. This screen shows the raw GPS data collected—just timestamps, longitudes, and latitudes. It’s not intended for visualization but rather supports the map views in the other two screens.
If you’re seeing data here but nothing on the map, it likely means one of the configuration steps above has been missed, or the employee was not scheduled to work during the time in question.
Final Thoughts
Acumatica’s map-based location tracking features work seamlessly when properly configured. The combination of real-time tracking and historical trajectory makes it easy to manage field staff, respond to customer needs, and validate productivity in a visual, intuitive format. If you're seeing only raw coordinates and not the full map, double-check your preferences, tracking settings, mobile permissions, and employee schedules. With everything in place, you’ll unlock a powerful visibility tool for your service operations.