# Employee Geolocation

<p class="doc-lead">Employee Geolocation shows real-time location markers for field employees on a map. Use it to verify site visits, client meetings, and route coverage for staff who work outside the office.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/hr/employee-geolocation?id=overview">Overview</a>
<a href="#/hr/employee-geolocation?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/hr/employee-geolocation?id=layout">Screen Layout</a>
<a href="#/hr/employee-geolocation?id=best-practices">Best Practices</a>
<a href="#/hr/employee-geolocation?id=faq">FAQ</a>
<a href="#/hr/employee-geolocation?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview</h2>

The Employee Geolocation screen displays a Google Map with location markers for employees who have shared their location through the mobile app. Locations refresh automatically every 15 minutes.

<img src="hr/images/e-emp-geo.webp" alt="Employee Geolocation map" loading="lazy">

This feature is designed for field sales representatives, service technicians, and other mobile staff whose work requires them to be on the move.

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start</h2>

<h3>1. Navigate</h3>
Go to <b>HRMS → Employee Geolocation</b>.

<h3>2. Select date</h3>
Choose the <b>Date</b> for which you want to view locations.

<h3>3. Submit</h3>
Click <b>Submit</b> to load location data for that date.

<h3>4. Select employees</h3>
Use the checkboxes in the left sidebar to select one or more employees. Their markers appear on the map with name and time labels.

<hr class="doc-section-divider">

<h2 id="layout">Screen Layout</h2>

| **Area** | **Description** |
|----------|-----------------|
| Date filter | Select the date to view locations. |
| Submit | Load location data for the selected date. |
| Left sidebar — Employee list | Checkboxes to select employees. Shows <b>Show all</b> when one employee is selected. |
| Time precision slider | Adjust time range when a single employee is selected. |
| Map | Google Map with location markers showing employee name and timestamp. |

<hr class="doc-section-divider">

<h2 id="best-practices">Best Practices</h2>

<ul>
<li>Ensure field employees have the mobile app installed and location sharing enabled.</li>
<li>Use the time precision slider to focus on a specific time window when reviewing a single employee's route.</li>
<li>Combine with attendance records to verify that field staff were at expected locations during working hours.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>How often does the location update?</b><br>
The system refreshes employee locations every 15 minutes automatically through the mobile app.

<b>Which employees appear on this screen?</b><br>
Only employees who have shared their location through the Freespace mobile app on the selected date.

<b>Can I view historical routes?</b><br>
Yes. Select a past date and submit to view location markers recorded on that day.

<b>Why is an employee missing from the map?</b><br>
Location sharing may be off, the app was not running, or no GPS fix was recorded on that date.

<b>Does geolocation replace attendance check-in?</b><br>
No. It is a supervisory map — official attendance still comes from check-in/out on attendance or mobile attendance entry.

<b>Can I filter by department?</b><br>
Use department filter on the form before submit to limit markers to selected organizational units.

<hr class="doc-section-divider">

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/hr/employees">Employee</a> — employee master records.</li>
<li><a href="#/hr/daily-attendance">Daily Attendance</a> — verify attendance against field locations.</li>
<li><a href="#/field-sale-app/hr-and-payroll/attendance">Field Sale App — Attendance</a> — mobile attendance for field staff.</li>
</ul>
