# Geo Channels

Geo channels let you define in-game zones that automatically switch your transmitting and scanned channels based on your location.

For example, entering a downtown area can automatically switch your radio to the **City** channel, while driving on the highway can switch it to the **Highway** channel.

## Creating Geo Zones

### Via Radio Panel

<details>

<summary>Geo Zones via Radio Panel</summary>

In the **Geo Zone** tab, use the polygon, rectangle, or circle tool to create a custom zone on the map. Select the zone to customize the name, z coordinates (floor and ceiling height), and the channels to automatically transmit and scan when entered.

Additionally, you can enter comma separated ACE permissions for the zone. When configured, the zone will only apply to users with those ACE permissions.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FU61lSfhmiHuxsoyiGWcT%2Fimage.png?alt=media&#x26;token=3c8c3df5-50ad-4471-8548-5e72df5a0f34" alt=""><figcaption></figcaption></figure>

</details>

### Via In-Game Menu

<details>

<summary>Accessing the Menu</summary>

Open the menu with the in-game `/radiomenu` command and select `Geo Channels`

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FwWQ7SXSkQbkE8Zt0qkMI%2Fimage.png?alt=media&#x26;token=04b4cf8e-c787-46e4-95a3-a50f9d09805c" alt=""><figcaption><p>Sonoran Radio - In-game Menu</p></figcaption></figure>

</details>

<details>

<summary>Zone Configuration Options</summary>

In the `Geo Channels` menu, you can specify which channels you want to transmit and scan upon entering, ace perms required to auto switch, add points to create a 3D zone and toggle auto switching on and off.&#x20;

<p align="center"><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2F0P1QoBhQhPu61YariKY4%2Fimage.png?alt=media&#x26;token=4ad5cd92-aba1-4bee-814c-adee6bd935f8" alt=""> <img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fw7RNCF70sTja4kNcTMIq%2Fimage.png?alt=media&#x26;token=762e4bcf-dbaa-4cfc-af2d-c7be5cf59183" alt=""></p>

`Add Point to Zone`

* Adds another point to the 3D zone

`Undo Last Point`

* Removes the last placed point from the 3D zone

`Min Z`

* The minimum Z value (floor height) of the 3D zone

`Max Z`&#x20;

* The maximum Z value (ceiling height) of the 3D zone

`Finish Zone Creation`

* Finishes the 3D zone creation and saves to the `geochannels.json` file

`Cancel Zone Creation`&#x20;

* Cancels the 3D zone editor and closes the menu

`Edit Geo Zones`

* Opens the Geo Zone editor menu

`Select Zone`

* Select the zone you would like to edit &#x20;

`Transmit Channels`

* The channels you will automatically join and transmit in upon entering the zone, and leave upon exiting the zone

`Scan Channels`

* The channels you will automatically join and scan in upon entering the zone, and leave upon exiting the zone

`ACE Permissions`&#x20;

* The ACE permission required for the auto switch to happen upon entering/ exiting the zone. If left blank **ALL** radio users will join and exit the channel upon entering that zone

</details>

<details>

<summary>View and Remove Configured Geo Zones</summary>

Select `Edit Geo Zones` in the menu and toggle on `Show Zones`. All configured zones on the map will be displayed in green. If the config.lua's `debug` mode is set to true, all zones will also be made visible.

Use the `Select Zone` menu option to swap back and forth between zones. Your selected zone will be displayed in red.

Use the `Delete Zone` menu option to delete the selected (red) zone.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FI437WxO64RCDjiN8hzyY%2Fimage.png?alt=media&#x26;token=a7fe39af-9742-4b25-95bc-ba4338695db0" alt=""><figcaption><p>Degredation Zone: Visible and Selected</p></figcaption></figure>

</details>

## Commands and ACE Permissions

<details>

<summary>FiveM Geo Channel Config + ACE Permissions</summary>

In the [config.lua](https://docs.sonoransoftware.com/radio/getting-started/installing-the-in-game-resource#updates)'s `Config.geoChannels` property allows for additional customization.

**User Toggle**

Users can use `/radio geoswitch` to toggle the auto-switcher on/off for themselves.

An optional `acePermission` can be added to restrict this command to specific users.

</details>