# Map

Using the map component allows you to display device locations and measured values on a map. Both dynamic devices that actively send changing location data and static devices may be presented on the map.

### Prepare Static Devices

For static devices the location information will be taken from a custom field. In your workspace create a custom field of type "GPS coordinates".

<figure><img src="/files/ItPPjyVqmnnDxk9iGm0W" alt=""><figcaption><p>Location custom field of type "GPS coordinates"</p></figcaption></figure>

Edit your device to add the "GPS coordinates" custom field and add latitude and longitude data.

<figure><img src="/files/kkmlq6RUCxS1UX2GkuEz" alt=""><figcaption><p>Add coordinates to Location custom field in edit mode</p></figcaption></figure>

<figure><img src="/files/QH1FcFfOsUWR7hA4CcbS" alt=""><figcaption><p>Option to select coordinates from map</p></figcaption></figure>

<figure><img src="/files/nCvnr0HgnHY2uQPx8dZn" alt=""><figcaption><p>Location field with latitude and longitude information</p></figcaption></figure>

### Setting up a map component

In the content tab define the zoom level and location of the map center and a heading if needed.

<figure><img src="/files/BtFw0OrIUBHJmR0VJGHp" alt=""><figcaption><p>Map component content setup</p></figcaption></figure>

In the Source tab of the map component add one or more devices to show on the map. For static devices select the previously created custom field as the location field. For dynamic devices select the respective topic and data key that contain the location information.

#### Layers

You may add a new layer for each type of device you are adding to the map component. Devices, locations and data point markes may be set for each layer. Also, layer can then be selected to displayed or hidden in the map component on the dashboard.

<figure><img src="/files/vBEO2aGhzMWEc9xD43sD" alt=""><figcaption><p>Configuring the source of a map component</p></figcaption></figure>

Use the marker data point options to showcase additional information next to the device marker on the map.


---

# 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.akenza.io/akenza.io/dashboard-builder/components/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.