# Locations

{% hint style="info" %}
**Who can use this feature?**

All Project Users can allocate a Location to their Tasks.

***

Project Admins can create and manage the Library of available Locations and External Map Layers.
{% endhint %}

The Location library is where you create and manage all Locations for your Project. Locations can be geolocated maps that connect to external layers like ArcGIS or drone flyovers, or static images to represent a zone, floor, or layout. Each Task can be assigned to a Location - which can then be used in filters, to group the plan, or to open Map Views.

## Creating a Location

***

Pick a Location type, set a name and save it to your Project's library.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F4bcbFfXSC3HychfeElLu%2FAdd%20Location.svg?alt=media&#x26;token=a5f907eb-25f7-4f9c-845a-485d5ed4d867" alt=""><figcaption></figcaption></figure>

#### To create a Location:

* Click your Project Title in the top left
* Select `Project Assets`
* Select `Location` from the menu
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FIUssEN3mX8LXegwHUyTw%2FCreate%20Location%20Button.svg?alt=media&#x26;token=b692ceca-230e-415e-acb1-47b42b6b7a76" alt="" data-size="line">
* Pick a Location Type; `Model Space`, `Real World` or `Off Site`
* Give your Location a name and select <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FeYEqEYsjVirv6Vn2Fq1C%2FAdd%20Location%20Button.svg?alt=media&#x26;token=795fd0d0-6a55-4692-8555-7494e2677634" alt="" data-size="line">

See also: open a <a href="map-and-clashes" class="button secondary">Map View</a>

## Map Space Locations

***

These are real-world Locations with coordinates - similar to Google Earth. You can switch between base maps (satellite or street), and connect external layers to give the team extra context while they’re planning.

### Add External Map Layers

You can connect up to 10 external map layers to a Map Space Location. These layers come from tools like ArcGIS or drone services like Propeller, and let your team overlay context - like utilities, survey data, or design drawings - directly in the Map. Layers can be shown or hidden as needed to help mark up work areas or communicate plans more clearly.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUajCFj4NClTv6mzFKoT8%2FAdd%20Layer.svg?alt=media&#x26;token=db75664a-7df6-4307-8ac2-7dd49fb868ef" alt=""><figcaption></figcaption></figure>

#### To add a Map Layer:

* Click your Project Title in the top left
* Select `Project Assets`
* Select `Location` from the menu
* Click into your Map Space Location
* Select <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fqy8cP2l0bpYxJKUovPsR%2FAdd%20Layer%20Button.svg?alt=media&#x26;token=293ed3c3-d3db-4814-8d74-78588cc6a337" alt="" data-size="line">
* Paste in your Layer URL and click `Continue`
* If required, select the correct Credential to access the layer
* Review the Layer Summary and click  <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FylSP9U4xxpeEOMQR9VoC%2FConfirm.svg?alt=media&#x26;token=5140283e-75fe-418e-a945-4e5f817c1bf2" alt="" data-size="line"> to add the layer to the Location

See also: <a href="../../integrations-and-api/external-map-layers/arcgis-set-up-guide" class="button secondary">Connect to ArcGIS</a>

### Layer Policies

When you connect a layer, Aphex will detect all available sublayers. Layer Policies help you control which ones are brought into your project - and whether they stay synced automatically or not.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Ff9svvJrqAPZyHgnvUKQr%2FSub%20layer%20policies.svg?alt=media&#x26;token=8b69fe15-64fa-4f3d-b0d6-cc9a6d4048bc" alt=""><figcaption></figcaption></figure>

#### &#x20; Set a Layer Policy

* Open the `Configure Location Layer` menu
* Click into the `Layer Policy` dropdown&#x20;
* Make a selection from: `Most Recent`, `Change Over Time`, `All Layers` or `Custom Selection`
  * If you select `Custom`, use the ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUmk4xHroFcifJzozWIty%2FGrab%20Select.svg?alt=media\&token=2d16c5b8-ca42-4e97-882e-f4bb8c21a5d8)checkboxes to manually pick sublayers
  * If you select `Most Recent`,  define the `Layer Quantity`&#x20;
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FylSP9U4xxpeEOMQR9VoC%2FConfirm.svg?alt=media&#x26;token=5140283e-75fe-418e-a945-4e5f817c1bf2" alt="" data-size="line"> to add the layer to your Location
* The selected policy will apply to both existing and future sublayers

These policies & selected Sublayers can be changed at any time.

<details>

<summary>Layer Policy Definitions &#x26; Behaviour</summary>

**Most Recent\***

* Automatically updates with your most recent sublayers - choose up to 3

**Change Over Time\***

* Automatically updates to include your newest, median and oldest sublayers

**All Layers**

* Includes all sublayers and automatically connects to new sublayers

**Custom Selection**

* Choose which sublayers you want included - selected sublayers will update automatically, but new sublayers require manual selection

\**Temporal order is inferred from the layer order (bottom = oldest, top = newest) as dates aren’t always available*

Sublayers that were not successfully connected will display a ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FXHpm3qoTVmfEPOVEqKw4%2FRight%20Item.svg?alt=media\&token=d7516a19-b306-43ad-8700-d74f095017b9) icon next to the sublayer name - please check your source Layer service for more information.

</details>

## Model Space (Drawing) Locations

***

Model Space Locations use a single uploaded image, like a site GA, floor plan, or layout export as the base for marking up Work Areas.&#x20;

#### Uploading a Location Image

* Click your Project Title in the top left
* Select `Project Assets`
* Select `Location` from the menu
* Click into your Map Space Location
* Select <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fqy8cP2l0bpYxJKUovPsR%2FAdd%20Layer%20Button.svg?alt=media&#x26;token=293ed3c3-d3db-4814-8d74-78588cc6a337" alt="" data-size="line">
* Select the file you want to upload
* Select <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FylSP9U4xxpeEOMQR9VoC%2FConfirm.svg?alt=media&#x26;token=5140283e-75fe-418e-a945-4e5f817c1bf2" alt="" data-size="line"> to add the image to the Location

#### Replacing a Location Image&#x20;

* Locate the Location you'd like to replace
* Hover the Image layer and click  `...`
* Select `Replace File`
* Upload your replacement image and confirm

{% hint style="danger" %}
**Be careful when replacing the Location Image**

Image replacements must match the original dimensions exactly. Work Areas are fixed to points on the image, if the scale or aspect ratio changes, Tasks risk being misaligned and may need to be redrawn.
{% endhint %}

<details>

<summary>Supported Model Space File Types</summary>

* PDF, JPEG (JPG), and PNG are the accepted file types for uploading images to Model Space (drawing) locations

</details>

## Off Site Locations

***

Off Site Locations are simple placeholders for areas that aren't part of the site map. They're helpful for tagging work that happens elsewhere (like a precast yard) without need for a visual representation.

Off Site Locations cannot be opened in a Map View, and no Work Areas can be marked up on them.

## Archiving a Location

***

Archiving a Location removes it from active use - it can't be opened in Map View or assigned to Tasks. The data is still part of the project's history and you can restore it at any time if you need to bring it back.

#### To archive a Location:

* Locate the Location you'd like to replace
* Hover the Image layer and click  `...`
* Select `Archive`

## Assigning a Location to your Tasks

***

Each Task can be assigned to a Location from your Project's library - the first step in showing that Task on the Map.

**To assign a Location:**

* On the Gantt, use the Column Picker <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FvKmhsEo7KN1cBILxsani%2FColumn%20Picker%20Buttons.svg?alt=media&#x26;token=9c6cc79d-7f88-4492-a6ea-7f2ba6418ffc" alt="" data-size="original"> to enable the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrvTcctNRDtoOHaw7U9zU%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOn.svg?alt=media&#x26;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Location`  column
* Click the Location cell for your Task and choose a Location from the dropdown

See also: mark up a <a href="../clashes-and-work-area#marking-up-a-work-area" class="button secondary">Work Area</a>

## Group by Location

***

Group Tasks by Location to organise your plan by where work is happening. It's possible in all View Types, but let's first take a look at grouping by Location on the Gantt:

#### Group by Location on the Gantt:

* Open a Gantt View
* Click the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F3oofYkeyY0B6LQb6YzOb%2FSub%20Nav%20Buttons%20(1).svg?alt=media&#x26;token=b752f56a-c695-45a9-a45d-c0f6f35d8ec4" alt="" data-size="line"> menu in the top left
* Select `Location` as the primary grouping
* Tasks will be arranged into groups based on their assigned Location
* Use the **`⋮⋮`** to drag and reorder groups as needed

## Filter by Location

***

Filter by Location to focus on Tasks happening in a specific area or zone.

#### To set a Location Filter:

* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F1uSzhSb5aSNnZd5vTaGB%2FFilter%20Button.svg?alt=media&#x26;token=8ddd7f1c-0296-4af2-bdeb-d08d56fc56b6" alt="" data-size="line"> and <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FbVv9qtyepRHQfkVwypud%2FText%20Buttons%20(2).svg?alt=media&#x26;token=fce29edb-8b74-4d75-bfa0-d8ad7292c94b" alt="" data-size="line">
* Select `Location` in the first dropdown
* Select from `Is`, `Is Not`, `Is Empty` in the second dropdown
* Select your desired Location in the third dropdown

See also: create & share <a href="view-controls" class="button secondary">Views</a>
