# 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="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FCJw0u5FNMCK05rQclE8k%2Fasset-map-1.png?alt=media&#x26;token=5d595436-509c-4d79-80e9-3aeb19eb3a07" 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="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2F02mNDuqbOfIu8ato4BMo%2Fasset-map-2.png?alt=media&#x26;token=6b97c3dc-9ae9-4c10-aaf1-ea186e80681e" 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="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2F1iOHH996pY3Lp3KqiGhP%2Fasset-map-3.png?alt=media&#x26;token=1b396801-ceb1-4c8d-83d0-d78ad4aa0e11" alt=""><figcaption></figcaption></figure>
