{% hint style="info" %}
This submodule is built into the Sonoran CAD FiveM resource and requires no additional configuration.
{% endhint %}
### 1. 2D Map Selection
In the admin panel, navigate to **Advanced** > **In-Game Integration** > **Live Map**
Here, you can enable and select a default map option for GTA, Roblox, or others. Additionally, pro communities can [upload a custom map](#using-a-custom-map-fivem).
Sonoran CAD - Live Map Type Selection
### 2. Set Your API ID
Don't forget to have each community member set their account [API ID](https://docs.sonoransoftware.com/cad/api-integration/getting-started/setting-your-api-id) to properly link their in-game user to the CAD.
### 3. User Access Permission
Users will need to be granted access to view the live map. This can be done via [Discord role sync](https://docs.sonoransoftware.com/cad/integration-plugins/discord-bot-integration), [permission key](https://docs.sonoransoftware.com/cad/tutorials/getting-started/permissions#permission-keys), or by [manually granting permissions](https://docs.sonoransoftware.com/cad/tutorials/getting-started/permissions#manually-granting-permissions) in the admin menu.
### **4. Enjoy!**
In the Police, Fire, EMS, or Dispatch window you can now click the "Live Map" button to view your new live map! Selecting a blip will show it's updated position and unit information.
This is found in the task bar's start menu under **Unit Management** > **Live Map**\
You can also [pin the live map button to your taskbar](https://docs.sonoransoftware.com/cad/tutorials/customization/customizing-your-layout#7-tab-system) for easy access.
{% hint style="info" %}
The live map will only show units that are in your server and also actively logged into the police, fire, or EMS panel in the CAD. Be sure to have your [API ID](https://docs.sonoransoftware.com/cad/api-integration/getting-started/setting-your-api-id) set.
{% endhint %}
## **Using the Live Map**
### **Map Controls**
#### **Postal and Location Search**
{% hint style="warning" %}
The postal search functionality requires the **Pro** version of Sonoran CAD.
For more information, view our [pricing](https://docs.sonoransoftware.com/cad/pricing/faq) page.
{% endhint %}
With the [postals](https://docs.sonoransoftware.com/cad/integration-plugins/in-game-integration/fivem-installation/available-plugins/postals) submodule configured, you can manually enter and search for a postal code on the live map.
Units, emergency calls, and dispatch calls with locations will also display a red pin icon. Clicking the icon will open the map and zoom to the location.
#### Blip Customization
You can toggle specific blips visibility and outline colors for police, fire, EMS, and dispatch.
### **Unit Blips**
Unit blips display the live location of all police, fire, EMS, and dispatch units in-game. You can hover over a unit for brief details, or click on one for more options.
You can also easily filter the map to specific units by selecting them in the active units panel.
#### Menu Options
Clicking on a unit blip allows you to add the unit to a call, add the unit to a group, send the unit lookup results, edit the unit's information, toggle their panic state, and more.
#### Drag-and-Drop
{% tabs %}
{% tab title="Roblox 2D" %}
Unit Blips Support:
* Drag to the call editor
* Drag to an active call
* Drag to a unit group
* Drag to the unit group header to create a new group
* Drag to the lookup window or minimized tab
* Drag to the timer window or minimized tab
* Drag to the tone board window or minimized tab
{% endtab %}
{% tab title="FiveM 2D" %}
* Drag-and-drop an ERS Callout
* Drag-and-drop a dispatch call to a location
* Drag-and-drop a dispatch call to the editor
{% endtab %}
{% tab title="FiveM 3D" %}
* Drag-and-drop an ERS Callout
* Drag-and-drop a dispatch call
{% endtab %}
{% endtabs %}
### Emergency Call Blips
Emergency calls placed in-game will also appear on the live map. You can hover over the blip for the call details.
#### Menu Options
Clicking on the emergency blip allows you to import the call to your editor or remove the emergency call.
### Smart Sign Blips
[Smart signs](https://docs.sonoransoftware.com/cad/integration-plugins/in-game-integration/fivem-installation/available-plugins/smart-signs) will also appear as blips on the map. You can click on these to edit the signs in-game.
## FiveM Custom Map
{% hint style="danger" %}
This feature requires the **pro** version of Sonoran CAD.\
For more information, view our [pricing](https://docs.sonoransoftware.com/cad/pricing) page.
{% endhint %}
Sonoran CAD allows communities to upload custom map images to the integrated, hosted live map. If your community does not use one of the map types provided, you can upload the images manually.
Extract Images
Extract the images from the YTD files with a program like OpenIV.\
**You will need six files named exactly as follows:**\
`minimap_sea_0_0.png`\
`minimap_sea_0_1.png`\
`minimap_sea_1_0.png`\
`minimap_sea_1_1.png`\
`minimap_sea_2_0.png`\
`minimap_sea_2_1.png`
Upload Images
Navigate to Admin > Advanced > In-Game Integration > Live Map and Push Events\
Select "Upload Custom" and upload all six correctly named files.
File Size
Custom map images are limited to 30MB each. **However, if you are uploading more than 100MB of images total, you will need to upload in separate batches.**
### Roxwood Expansion
Roxwood Expansion
If your community is utilizing the Roxwood map expansion, there will be additional tiles to upload.
* `minimap_sea_-1_-1.png`
* `minimap_sea_-1_0.png`
* `minimap_sea_-1_1.png` (Optional, blank tile to the right)
Additionally, two existing map tiles will need to be updated, as they contain parts of both the main island and the Roxwood expansion.
* `minimap_sea_0_-1.png`
* `minimap_sea_0_0.png`
* `minimap_sea_0_1.png`
### Cayo Perico Expansion
Cayo Perico Expansion
If your community is utilizing the Cayo Perico map expansion, there will be extra tiles to upload. Ensure these are named as:
* `minimap_sea_2_1.png`
* Bottom right of the main island + top right of Cayo Perico
* `minimap_sea_2_2.png`
* `minimap_sea_3_1.png`
* `minimap_sea_3_2.png`
## Roblox Custom Maps
{% content-ref url="../../../erlc/3d-live-map" %}
[3d-live-map](https://docs.sonoransoftware.com/cad/integration-plugins/erlc/3d-live-map)
{% endcontent-ref %}
## Troubleshooting
### 3D Live Map not Loading
The 3D live map uses WebGL, an open source something.
In Chrome, navigate to `chrome://gpu/` and check if `WebGL` is **Disabled**. If so, try the following steps:
* **Chrome** > **Settings** > **System** > **Use Graphics Acceleration When Available**
* Ensure Graphics Drivers are Up-to-Date
* Fully restart your web browser
