# Unit Tracking Map

{% hint style="warning" %}
This plugin requires a **Premium ImperialCAD subscription**.

View our [pricing](https://imperialcad.app/pricing) for more information.
{% endhint %}

***

### 🚀 Getting Started

#### Step 1: Enable LiveMap

In your resource’s configuration file, set:

```lua
Config.livemap = true
```

By default, this is set to `false`.

***

#### Step 2: Postal Mapping

To display postal codes on the map:

* Go to ImperialCAD Admin panel; **Settings → Integrations → Postal Mapping**
* Upload a `postals.json` file

The system will automatically apply the mapping for your LiveMap.

***

### 🔄 Data Updates

* **Player Updates**:
  * Sent from in-game to the LiveMap every **3.5 seconds**
  * If the player has not moved since the last update, the refresh interval increases to **10 seconds**
* **Unit Information & Postals**:
  * Sent and received based on map activity (user placement and interaction)
  * Cached on the server side and updated periodically
* **Data Sync with CAD**:
  * User data may take up to **1 minute** to fully update and match CAD records
  * This delay is expected as the LiveMap is an external resource.

***

### ⚠️ Notes & Limitations

* LiveMap is **new and evolving**, so expect minor delays in data synchronization
* CAD-linked data is cached and may not appear instantly
* Future updates will improve refresh speed and stability


---

# 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://docs.imperialcad.app/api-and-integrations/fivem-installation/offered-plugins/unit-tracking-map.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.