# Asset Map

The Asset map widget allows you to view the current position of a device or its directional path within a selected timeframe using a set of points that represent the recorded data locations.

{% hint style="info" %}
The Asset Map widget is available on the global dashboards.
{% endhint %}

In the **Widget options** modal, configure the following:

In the **Name** text box, enter a name to identify the asset map within the dashboard.

In the **Device Type** drop-down, select the **device type**.

In the **Data field** drop-down, select the **data field** that you want to display on the map.

In the **Devices** text box, select the **device** or **devices** that you want to display on the map. You can select multiple devices for the selected device type.

<figure><img src="/files/1Z4RMNmbm1HAX1HNmGdX" alt=""><figcaption></figcaption></figure>

You can display a device on the map in two ways: either by its **current position** or by showing a **directional path with a set of points**.

### **Directional path with a set of points**

This is the default option to display a device on the map.&#x20;

Click on the '**Path color**' color picker and select the color to apply to both the path and the points.

Choose the desired timeframe using one of the following options:

* Click on the **Last from** text box and select a predefined timeframe from the list. If the desired timeframe is not available, you can manually type a timeframe, such as '3 days', '7 weeks', etc. Note that '3 days' refers to the last three days, including today, for example. Here is a list of predefined timeframe presets: `1 hour`, `1 day`, `1 week`, `1 month`, and `1 year`.
* Define a custom date range by selecting the **start date** and **end date**, including the start time and end time too from the date pickers.

### **Current position**&#x20;

Click on the **Current position** checkbox. The Path color, Last from, and Time range UI controls will hide.&#x20;

Enabling this option will show the current/live position of the device on the map.

You can add more **Device Types** by clicking on the **+** button.

The following Widget options modal is configured for 4 Device types, for example:

<figure><img src="/files/m1t3s9bP9gBLeRSeNIb8" alt=""><figcaption></figcaption></figure>

Click on the **Save** button to save the configuration.

The resulting **Asset map** widget will look something like this:

<figure><img src="/files/nZUHZEEBgzrW8K9Ct0jF" alt=""><figcaption></figcaption></figure>


---

# 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.widgelix.com/get-started/widgets/asset-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.