# Map

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

Project Users with Full Planner Access can create and open Map Views.
{% endhint %}

Map View gives you a visual way to track work on site. Use it for daily coordination, spotting clashes, creating automatic staging diagrams, or to walk others through what’s happening; where, when & who. Maps can be simple floor plans or real-world maps with coordinates, and can connect to external layers like GIS data or drone imagery.

Every Task on the Map is tied to the schedule, so when the plan moves, the Map automatically updates too.

## Open a Map View

***

Each Project can have multiple Maps. From static Site GAs to geolocated Maps - pick the one you want to view and work with. You'll only see Tasks linked to that Map.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FALB6aK1B5tuQupWOoXbC%2Fmap%20view%20-%20open%20map%20view.svg?alt=media&#x26;token=81d8fcdb-ec2d-4713-b158-16f736392b8b" alt=""><figcaption></figcaption></figure>

#### To open a Map View:

* Click  `+ Views` at the top of the View Tabs
* Scroll through Views you & your team have created, or Views Aphex has provided
* Open any <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fqe5xtun2jJ6ozp6WHVIM%2FMap%20Icon%20New.png?alt=media&#x26;token=e570cc06-1cc3-4b2b-85b4-46d3e21364ed" alt="" data-size="line"> Map View

#### To change which Map you're viewing:

* Open any Map View
* In the top left, open the Map Selector
* Click into the Map you want to open

See: <a href="locations" class="button secondary">Locations</a> and <a href="../printing#print-map-view" class="button secondary">Printing the Map</a>

## Set the Date Range

***

Use the Date Picker to show what's happening on site for a certain day, week, month or custom range.&#x20;

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FBxpbdHa8QTdNB5ukZntk%2Fmap%20view%20-%20date%20range.svg?alt=media&#x26;token=69548966-384c-472b-829f-f25a869ffed2" alt=""><figcaption></figcaption></figure>

#### To choose what time frame you want to see on the Map:

* Click the Date Range at the top of the Map
* Pick one of the shortcuts: `Today`, `Next Week`, `This Month` or use the calendar to select a specific date range
* Use the `<` arrows `>` to move forward or back in time

<details>

<summary>Date Range Options</summary>

| Option                 | Function                                                          |
| ---------------------- | ----------------------------------------------------------------- |
| `Lookahead`            | Current Week + (Project Lookahead Period - 1 Week)                |
| `Today`                | Today’s Date                                                      |
| `This Week`            | Monday to Sunday of the Current Week                              |
| `Next Week`            | Next Monday to Sunday (1 week into the Future)                    |
| `Custom`               | Custom dates selected by the user                                 |
| Advance Selected Range | Move the date range forwards and backwards by your selected range |

</details>

## Organise the Task List

***

The Task List on Map Views can be organised into different groups, depending on what type of set up you need.

#### To change the Grouping on Map:

* Click <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"> at the top of the Map View
* Select how you want to group tasks

<details>

<summary>Grouping Options</summary>

| Primary Group | Sub-Group     |
| ------------- | ------------- |
| Owner         | Folder        |
| Package       | Owner         |
| Folder        | Subcontractor |
| Subcontractor | Shift         |
| Shift         | None          |

</details>

## Interact with Tasks on the Map

***

Clicking a task on the Map will open its full details in a panel, right on top of the Map. You can view, update or progress the Task without moving away from your current view.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F0XBzD9PMDcUCu0VUkq7D%2Fmap%20view%20-%20TASK%20PREVIEW.svg?alt=media&#x26;token=3c8ede9a-8629-4235-bd59-1a696b842b19" alt=""><figcaption></figcaption></figure>

#### To open a Task on the Map:

* Click any Task Card from the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FvhqXhzDKJEkXH4T1NCDP%2FTasks%20Map%20Panel.svg?alt=media&#x26;token=a15fab7d-bb18-43bb-886e-477f6982dd09" alt="" data-size="line"> section on the left hand-side
* Or, click the Work Area <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FTpEloURcjcbOcMkzmtkd%2FWork%20Area.svg?alt=media&#x26;token=82dcad67-65a5-48f9-8b0e-7910a1063de8" alt="" data-size="line"> on the Map and then the ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F1WzPC2ISYyHlAadpOjd2%2FExpand%20Icon.svg?alt=media\&token=7cf60b86-7b9f-4c55-b269-d0731f8d5f31) icon
* The Task Panel will open

#### To record Task Progress from the Map:

* Click the Work Area <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FTpEloURcjcbOcMkzmtkd%2FWork%20Area.svg?alt=media&#x26;token=82dcad67-65a5-48f9-8b0e-7910a1063de8" alt="" data-size="line"> on the Map to open the Task Preview
* Click any of the Progress Bars, underneath any of the current or past Task Days
* Select <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FdR0lJrFqzXRkwq77leCL%2FThumbs%20Up.svg?alt=media&#x26;token=0b23234b-417e-4771-917f-6ea5a8299c64" alt="" data-size="line"> or <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FZpw6cJW8Cg2BiiaJP5Ua%2FStatus%20Buttons.svg?alt=media&#x26;token=af2f2296-758f-428c-b53f-c71328d40ced" alt="" data-size="line">
* Record the delay

See also: <a href="status" class="button secondary">Progress Updates</a>

## Show or Hide External Map Layers

***

You can toggle external map layers on or off to bring in additional site context, like utilities, drone flyovers, or design information, without crowding the Map view when they’re not needed.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FogeOI8k9vU9nEtUr4I9D%2Fmap%20view%20-%20layers%20(2).svg?alt=media&#x26;token=84a3f854-82b0-4541-820b-f7d5dea2e8a2" alt=""><figcaption></figcaption></figure>

#### To turn Map Layers on or off:

* Open a Map View
* Click into the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FemGAzWfvnuA7to1vl52A%2FLayer%20Button.svg?alt=media&#x26;token=e1493c6f-d9a4-4de4-908b-993800269f8c" alt="" data-size="line"> tab in the left-hand panel
* Use the ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FtmKa0esyx9sHu9S2hGQX%2FVisibility.svg?alt=media\&token=3947542b-038d-492c-a254-3ea86e810728) to turn Layers on and off
  * Toggle individual sublayers for more detailed control
  * Hold `SHIFT` then `Click` to turn multiple on and off at once

#### To switch the base map:

* Open a Map View
* Click into the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FemGAzWfvnuA7to1vl52A%2FLayer%20Button.svg?alt=media&#x26;token=e1493c6f-d9a4-4de4-908b-993800269f8c" alt="" data-size="line"> tab in the left-hand panel
* Swap between `Satellite`, `Street` or `None`

See also: <a href="../locations#add-external-map-layers" class="button secondary">Add Map Layers</a>

## Colour Code the Map

***

You can change how Work Areas are colour-coded on the map to reflect what matters most during planning. Switch between colours for Task Owner, Subcontractor, or Shift, or choose to highlight Clashes and Overdue Blockers in red when you need to spot issues quickly.

#### To change the colour of Work Areas:

* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FSNTOMbQrVpG7dcvB4Rv5%2FView%20Sub%20Nav%20Buttons%20(5).svg?alt=media&#x26;token=8f4a1cfb-c0e8-4054-8843-f0bf8f57de38" alt="" data-size="line"> and select `Work Area Colour`
* Pick from `Subcontractor`, `Owner` or `Shift`

#### To highlight Clashes or Blockers on the Map in red:

* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FSNTOMbQrVpG7dcvB4Rv5%2FView%20Sub%20Nav%20Buttons%20(5).svg?alt=media&#x26;token=8f4a1cfb-c0e8-4054-8843-f0bf8f57de38" alt="" data-size="line"> and select `Highlight Issues`
* Pick from `Clashes` or `Overdue Blockers`

## Filter the Map

***

Filters in Aphex let you show only what matters, whether that’s Tasks with certain properties, or ones that are missing something. Keep it simple or build something more detailed, it's up to you.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F2pAEzd1QYp8BgrXaLbAd%2Fmap%20view%20-%20filter.svg?alt=media&#x26;token=2b3bde18-e57e-4b94-8885-d19df884dc10" alt=""><figcaption></figcaption></figure>

#### To filter a Map View:

* 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"> at the top of the Map
* In the dropdown that appears select <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FC2z9eyXFRtv0OFKFDfvf%2FText%20Buttons%20(1).svg?alt=media&#x26;token=18c31a95-f3f0-480b-a5a6-85f07d588960" alt="" data-size="line"> and choose the property you'd like to filter by
* Change the logic from options like <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FiAhZyN1xUBzybGlrX4YV%2FString%20(1).svg?alt=media&#x26;token=27c850a7-87d3-401a-b44f-5949612b918d" alt="" data-size="line"> or <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FgfBJ8VfliepVd2I20zjC%2FString.svg?alt=media&#x26;token=8c17e4bc-a215-4ac4-bf39-c8fcc4976263" alt="" data-size="line"> to <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FurgIqS01dMxPoK7oac8c%2FString%20(3).svg?alt=media&#x26;token=884ba4da-ad57-4cc0-9db1-5689fc1595de" alt="" data-size="line"> or <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FHu7n6Qhr2esfx8O4bCng%2FString%20(2).svg?alt=media&#x26;token=c9ec383f-bda9-40a2-b531-57ba7fea3d11" alt="" data-size="line"> to hide or reveal the relevant Tasks
* Click to swap between <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FaITVVa1omSaRDIDMLUkS%2FField.svg?alt=media&#x26;token=c2ba7c48-d979-4192-984f-d9e05df4b3c9" alt="" data-size="line"> and <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FMfQH0Do9LhYNFj85rBsj%2FField%20(1).svg?alt=media&#x26;token=aabb5a5d-ed4d-42f0-aea1-e5fb2fd973b0" alt="" data-size="line">

&#x20;See also:  <a href="view-controls" class="button secondary">Saving a View</a> &#x20;

<details>

<summary>Filter Logic &#x26; Rules</summary>

* All <a href="broken-reference" class="button secondary">Task Properties</a> as well as <a href="broken-reference" class="button secondary">Unresolved Issues</a> can be applied as a filter
* Archived values that are still in use will appear as filter options. Unused archived values will be hidden from the filter options&#x20;
* Tasks that do not match the filter criteria will be hidden from the Map

</details>


---

# 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://help.aphex.co/docs/planner/features/map-and-clashes.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.
