# Locate

The security of your employees is an important concern. This page lets you find out the last known location of each employee.

## Locate your employees

The Locate page on the left menu is available to all companies as a basic functionality. The admin users will be able to check all the employees for their last known locations. The Locate page in FieldWorker provides a real-time geographical overview of your team's field activities. It combines an interactive map with a detailed activity feed to help managers monitor check-ins, task progress, and staff locations.

#### Interactive Map View

The top section of the page features a dynamic map (powered by Google Maps) that visualizes the distribution of your field staff.

* Location Pins: Purple markers indicate the last known positions of team members across the country.
* Map Controls: Users can zoom, pan, and toggle to a full-screen view using the icon in the top-right corner of the map.
* Global Overview: Provides a high-level look at staff density in specific regions (e.g., clusters in the Northeast vs. individual markers in the West).

#### Last Known Activity Feed

Below the map is a comprehensive list of the most recent field events. Each entry represents a specific staff member's interaction with a task:

<table data-header-hidden><thead><tr><th width="179.27490234375"></th><th></th></tr></thead><tbody><tr><td><strong>Feature</strong></td><td><strong>Details Provided</strong></td></tr><tr><td>Staff &#x26; Task</td><td>Displays the staff member's name, the specific task title (e.g., "MT task"), and the associated project.</td></tr><tr><td>Geographic Data</td><td>The exact address where the activity occurred and a "Last Updated" relative timestamp (e.g., "Updated 10 days ago").</td></tr><tr><td>Schedule vs. Actual</td><td>Compares the Scheduled Start/End times with the Last Check In/Out timestamps for auditing.</td></tr><tr><td>Current Status</td><td>A clear status indicator (e.g., Checked Out or Checked In) accompanied by a checkmark icon.</td></tr></tbody></table>

<figure><img src="/files/wG44GJAvXWcfQZluWW4s" alt=""><figcaption></figcaption></figure>

For each employee, the dashboard shows their last location, the time window when they were expected to be at that location, and the actual time that was spent at that location.

#### Navigation and Filtering

The [Locate](https://dev.fieldworker.ai/locate) page is integrated into the main sidebar for quick access.

* Sidebar Access: You can jump to this view at any time by clicking the Locate icon (map pin) in the left-hand navigation menu.
* Live Updates: The page serves as a "live" dashboard, meaning as staff check in via the mobile app, their data points and status updates appear here for administrative oversight.

#### Key Use Cases

* Safety Monitoring: Confirming that a staff member has arrived at a client's home safely.
* Verification: Ensuring that [Timesheets](https://dev.fieldworker.ai/timesheets) align with the actual GPS-stamped check-in times.
* Resource Management: Identifying which staff members are currently active or available based on their "Checked Out" status.

### How to Perform a Manual Checkout

On the Locate page, the "Checkout by Admin" functionality acts as a failsafe for managers to ensure that time tracking remains accurate even if a staff member forgets to clock out. This may be due to device failure, network failure, or even due to human error. While viewing the [Locate](https://dev.fieldworker.ai/locate) page, follow these steps to check out a staff member:

1. Identify the Active Task: Look through the Last Known Activity feed for any entry where the status is "Checked In" (indicated by a green icon or active timer).
2. Access the Task Actions: Click on the three-dot menu (⋮) or the specific task entry associated with that staff member.
3. Select "Checkout": In the options that appear, select the manual checkout action.
4. Confirm Details: A modal may appear asking you to confirm the Checkout Time. As an admin, you can often adjust this time to reflect when the staff member *actually* finished their work, ensuring the [Timesheet](https://dev.fieldworker.ai/timesheets) entry is correct.

In any such manual intervention, the admin is expected to record the actual reason for the manual intervention.

<figure><img src="/files/BQblU4axPoBwXZRBzhuY" alt="" width="563"><figcaption></figcaption></figure>

#### Why Admins Use This Feature

* Accuracy for Billing: Since FieldWorker uses these timestamps to generate [Billing](https://dev.fieldworker.ai/billing) and payroll data, manual checkouts prevent "over-clocking" caused by human error.
* EVV Compliance: It allows admins to finalize a visit that might have had technical issues in the field, keeping the record [Audit Ready](https://fieldworker.ai/disability-case-management-audits/).
* Real-Time Correction: If the map shows a staff member has clearly left the job site, but they are still "Checked In," the admin can resolve the status immediately from the office.

#### Status Indicators on the Locate Page

<table data-header-hidden><thead><tr><th width="137.01861572265625"></th><th width="264.96820068359375"></th><th></th></tr></thead><tbody><tr><td><strong>Status</strong></td><td><strong>Visual Cue</strong></td><td><strong>Admin Action</strong></td></tr><tr><td>Checked In</td><td>Active status / Green indicator</td><td>Can be manually "Checked Out" by Admin.</td></tr><tr><td>Checked Out</td><td>Gray checkmark / Checked Out text</td><td>Record is finalized; no further action needed.</td></tr></tbody></table>

> Note: Any manual changes made by an admin are logged in the system's audit trail to maintain transparency for future compliance reviews.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fieldworker.gitbook.io/fieldworker-docs/fundamentals/pages/locate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
