# map

## Overview

With the "Map" function, you can place assets on an interactive map. This makes it possible to trace the geographical distribution of all assets.

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/YmmgAyFSA5nicI95zMN3/2F7EC9F5-B06A-4A9E-8D6E-5E4B61E8C0B5.png" alt=""><figcaption><p>Fig. 1 – Overview of the "Map" menu</p></figcaption></figure></div>

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/qTQfvvGMrywfUlJPJRai/0CC5329E-683C-4164-959D-837CEF190D29.png" alt=""><figcaption><p>Fig. 2 – Overview of symbols used in the map</p></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="62"></th><th width="180"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Map</td><td>Interactive map</td></tr><tr><td><strong>[B]</strong></td><td>"Map" menu</td><td>Click to open the "Map" menu</td></tr><tr><td><strong>[C]</strong></td><td>Alarms in the displayed area</td><td>Shows an overview of all alarms in the currently visible map section. Not to be confused with [G]!</td></tr><tr><td><strong>[D]</strong></td><td>Navigation</td><td>See<a href="#in-der-karte-navigieren"> -> Navigate in the map </a></td></tr><tr><td><strong>[E]</strong></td><td>Placement mode</td><td>The <a href="#ein-asset-in-der-karte-platzieren">-> Turn placement mode on/off </a></td></tr><tr><td><strong>[F]</strong></td><td>Search</td><td>Activate search; the search is not only illustrated in the asset tree, but only the points on the map that match the search are also displayed.</td></tr><tr><td><strong>[G]</strong></td><td>All alarms</td><td>Shows all alarms present in the current project that the user has access to.</td></tr><tr><td><strong>[H]</strong></td><td>Sidebar</td><td>Context-sensitive sidebar. The content varies depending on what is currently selected. <br><br>When the "Maps" menu is opened, a list of all assets available in the project and accessible to the respective user is displayed by default. </td></tr><tr><td><strong>[I]</strong></td><td>"Building" icon</td><td>This icon indicates that the respective asset is of the type "Building".</td></tr><tr><td><strong>[W]</strong></td><td>"Floor" icon</td><td>This icon indicates that the respective asset is of the type "Floor".</td></tr><tr><td><strong>[J]</strong></td><td>Details</td><td>Click to open details for the respective asset</td></tr><tr><td><strong>[K]</strong></td><td>asset</td><td>Asset name. <br>Click on the asset name to go to the asset's location on the map.</td></tr><tr><td><strong>[L]</strong></td><td>"Asset" map symbol</td><td>This symbol appears on the map and represents an asset. Click this symbol to go to the <a href="../assets/asset-details">-> Asset details</a> to get to</td></tr><tr><td><strong>[M]</strong></td><td>"Multiple assets" map symbol</td><td>This symbol appears on the map and represents multiple assets. This symbol is displayed, </td></tr><tr><td><strong>[N]</strong></td><td>"Building" map symbol</td><td>This symbol appears on the map and represents a building. Click this symbol to go to the <a href="../assets/asset-details">-> Asset details </a>to get to</td></tr><tr><td><strong>[O]</strong></td><td>"Asset with subordinate alarm" map symbol</td><td>This symbol appears on the map and represents an asset whose subordinate asset is marked with an alarm. </td></tr><tr><td><strong>[P]</strong></td><td>"Assets with alarm" map symbols</td><td>This symbol appears on the map and represents an asset for which an alarm is present. The colored triangle symbolizes the respective alarm level. <br>You can find more details in the chapter <a href="../alarms-rules-and-escalations/alarms">-> Alarms</a> </td></tr><tr><td><strong>[Q]</strong></td><td>"Buildings with alarm" map symbols</td><td>This symbol appears on the map and represents a building for which an alarm is present. The colored triangle symbolizes the respective alarm level. <br>You can find more details in the chapter <a href="../alarms-rules-and-escalations/alarms">-> Alarms</a> </td></tr></tbody></table>

## Open map

Click in the sidebar on **Map \[B]**, to open the map.

The default map section is opened.

{% hint style="info" %}
You can define a separate default map section for each user.

Find out more under [-> Set default map section](#standard-kartenausschnitt-festlegen)
{% endhint %}

## Navigate in the map

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/hPsJtFfgUTFDM41pWzwq/CE5D73C8-28DE-4126-AC1C-E7EE4BAB6230.png" alt=""><figcaption><p>Fig. 3 – Detail of the navigation</p></figcaption></figure></div>

{% hint style="info" %}
An explanation of the abbreviations used can be found under [-> Typographical conventions](https://docs.buildings.ability.abb/collection/english-v14/foreword/typographic-conventions)
{% endhint %}

<table><thead><tr><th width="183"></th><th width="165.33333333333331"></th><th></th></tr></thead><tbody><tr><td><strong>LMB [drag]</strong></td><td>Move map</td><td>Move map section</td></tr><tr><td><strong>RMB [drag]</strong>  <em>or</em><br><strong>Ctrl + LMB [drag] -</strong> </td><td>Rotate / tilt map</td><td>Rotate map</td></tr><tr><td><strong>Shift + LMB [drag]</strong> </td><td>Area zoom</td><td>With this command, you can draw a rectangle on the map. When you release the LMB, the view zooms into this rectangle</td></tr><tr><td><strong>MOUSE WHEEL</strong></td><td>Zoom</td><td>Zoom in or out of the map</td></tr><tr><td><strong>[D1]</strong></td><td>Zoom in</td><td>Zooms into the center of the map</td></tr><tr><td><strong>[D2]</strong></td><td>Zoom out</td><td>Zooms out from the center of the map</td></tr><tr><td><strong>[D3]</strong></td><td>Home</td><td>Returns to the default map section </td></tr><tr><td><strong>[D4]</strong></td><td>Jump to current location</td><td>Jump to the user's current location. To use this function, an additional permission may need to be granted via the web browser.</td></tr><tr><td><strong>[D5]</strong></td><td>Show all assets</td><td>Zooms out far enough so that all existing and placed assets are visible on the map.</td></tr></tbody></table>

## Asset list

The asset list appears in the **Sidebar \[H]**, when the "Map" menu is opened.&#x20;

In the asset list, you can see all assets assigned to the project that you have access to.&#x20;

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/IfykeS6XLPv0dl91aGYJ/F14BEC8F-5269-4F48-B6FF-7CEEE2287583.png" alt=""><figcaption><p>Fig. 4 - Asset in the asset list</p></figcaption></figure>

Click on the name of an asset **\[K]**, to jump to its location on the map.

Click the symbol **\[J]**, to go to the asset details (Fig. 5).

In the asset details, you can:

* view the alarms of the asset,
* display the attribute values of the asset,

and navigate from there to other functions such as:

* the asset's rules,
* additional alarms,
* the asset's BIM model,
* the asset's digital twin,
* and the asset links.

The symbol **\[W]**, is only present if the asset is a floor. Click on **\[W]**, to go directly to the "Floor menu".&#x20;

{% hint style="info" %}
Learn more about floors in the chapter [-> Floors](https://docs.buildings.ability.abb/collection/english-v14/documentation/map-and-floor/floor)
{% endhint %}

The symbol **\[I]** is only present if the asset is a building.&#x20;

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/L9te6nqMJI1B8BeTO3xZ/9AE06B26-AAB9-45C0-BEFB-043778969519.png" alt=""><figcaption><p>Fig. 5 The "Asset details" appear in the sidebar</p></figcaption></figure></div>

## Place an asset on the map

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/QxDmGSKPLJmqVRfjMlze/97CF8D33-9FE2-4D34-BCF2-A2B6E7A85474.png" alt=""><figcaption><p>Fig. 6 – Placement mode</p></figcaption></figure></div>

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/QoRiFJ72Kz0DxUTuXcZw/76415A80-43F9-43DF-A90F-19FF66CFEBF9.png" alt=""><figcaption><p>Fig. 7 – Extended placement mode </p></figcaption></figure></div>

### Variant 1 – Directly via the map

1. Make sure that the menu **Map \[B]** is open
2. Activate the **Placement mode \[E]**\
   ▷ The sidebar **\[H]** switches to "Placement mode" (see Fig. 4)
3. Assets with the symbol **\[R]** have not been placed
4. Assets with the symbol **\[S]** have already been placed. Continue to change the placement.
5. Click the symbol **\[R]** or **\[S]**, next to the asset that you want to place. \
   ▷ The sidebar **\[H]** switches to "Extended placement mode" (see Fig. 7)
6. Navigate on the map to the place where you want to place the asset
7. Click on the location on the map where the asset should be placed.\
   ▷ The selected location is marked with a particularly large "Asset" map symbol **\[L]** marked
8. Click on **Save \[T]**, to place the asset.
9. If the asset was already placed: With **\[V]** you can remove the placement. &#x20;

Click on a map symbol **\[X]** to get to the asset details

### Variant 2 – Via the asset menu

1. [-> Create a new asset](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets/create-assets)[ or start editing an existing asset](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets/create-assets)
2. Click on \[X]\
   ▷ The map opens\
   ▷ Placement mode is activated automatically
3. If the asset to be placed is a floor: Activate the switch "Asset is a floor"
4. Navigate on the map to the place where you want to place the asset
5. Click on the location on the map where the asset should be placed.\
   ▷ The selected location is marked with a particularly large "Asset" map symbol **\[L]** marked
6. Click on **Save \[T]**, to place the asset.
7. If the asset was already placed: With \[V] you can remove the placement. &#x20;

## Set default map section

The default map section is the map area that is displayed by default when the "Map" menu is opened.

### Change for your user

Proceed as follows to change the default map section for your own user:

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/cZf2o77sOVONXUyanvJX/Docs_Karte%20-%20Standardspeicherort.png" alt=""><figcaption></figcaption></figure>

1. Click your username in the title bar **\[A]**
2. Click on **\[B]**\
   ▷ Your user settings open
3. Click on **\[C]**
4. Click on default location **\[D]**\
   ▷ A **Map selection \[E]** opens
5. Navigate in **\[F]**, to the point you want to define as the default location.
6. Alternatively, you can use **\[G]** to search for a location
7. Click on **Save \[H]**\
   ▷ The default location has been applied

{% hint style="info" %}
You must proceed exactly as described to open your user settings.

It is not possible via *Engineering -> User -> \[Your user]* to change the default location.
{% endhint %}

{% hint style="info" %}
In this way, you CANNOT change the default map section for other users.

If you want to configure a default map section for other users, use the function [-> Project roles](https://docs.buildings.ability.abb/collection/english-v14/documentation/roles/project-roles)
{% endhint %}

### Change via the project role

If you want to define a default map section for other users, you can do this via the [-> Project role](https://docs.buildings.ability.abb/collection/english-v14/documentation/roles/project-roles) do so.


---

# 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.buildings.ability.abb/collection/english-v14/documentation/map-and-floor/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.
