# Live location

The **Live Location** feature is primarily designed to **verify and test GPS tracking** in real time. While the app normally collects location history in **History Mode**, Live Location (also called **Track Mode**) allows you to check how GPS works and how location updates are displayed on the cPanel, especially in the **Location tab**.

<figure><img src="https://4187053630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjkSePRf5HsNK8f87ZonZ%2Fuploads%2Fgit-blob-e6146062a696f9790b2ea76f16880f47cacefec4%2Fimage%20(6).png?alt=media" alt="" width="188"><figcaption></figcaption></figure>

### How it works

* When enabled, the device will send live GPS updates every **15 seconds** (or **30 seconds**, depending on your configuration).
* By default, a live session lasts **15 minutes**. You can stop it at any time.
* If you want to share for a longer period, you can extend the duration between **1 hour** and up to **8 hours**.

### What the user sees

* On the cPanel, you will see a **live data stream** of the device’s location in near real time.
* The map in the **Location tab** will refresh automatically as new GPS coordinates arrive.
* This helps you confirm that the GPS tracking system is functioning correctly and that the device is reporting location accurately.

### Use cases

* **Testing/verification:** Ensure the GPS tracking works properly after installation.
* **Monitoring:** Temporarily share the device’s live movement for a specific time window.
* **Comparison:** Check the difference between continuous live tracking (Track Mode) and periodic location history (History Mode).

### Important note about Maps

* The Agent App itself does **not display maps** during Live Location.
* This is intentional to **save battery**, as the Agent App’s role is limited to collecting and sending GPS data.
* To view the live map, you can use the **cPanel (web dashboard)** or the **Admin App**, where the data is visualized on a map in real time.

### Why this design?

* **Battery efficiency:** Constantly rendering maps on the device would drain power quickly.
* **Clear role separation:** The Agent App focuses on data collection; the Admin side (cPanel or Admin App) focuses on visualization.
* **Lightweight operation:** Ensures the Agent can run quietly in the background without consuming extra system resources.
