# Azure Maps - Maplytics List Control

Maplytics List Control is a PCF Control of Maplytics integrated Azure Maps.

Maplytics List Control is available on Views of Dynamics CRM, see the below screenshot for reference.

Note: The Azure Maps license key is required to configure and access this control.

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2FyeNR4yXWDUfZSSPHeEyU%2Fimage.png?alt=media&#x26;token=eb6510fa-505e-47a9-9964-60c97c43666d" alt=""><figcaption></figcaption></figure>

Configuration of Maplytics List Control

Let us see how to configure the view.

1\.       Log into Power Apps.

2. Navigate to Entities and select Account (or any preferred entity).

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2FM7CCodDzA7VytdSXE8YY%2Fimage.png?alt=media&#x26;token=d4730658-941a-4503-866f-a72c722d1b37" alt=""><figcaption></figcaption></figure>

3. Choose the View where you want to configure the Maplytics List Control.

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2FfTcYPVYHTcDQcobsmFHF%2Fimage.png?alt=media&#x26;token=b9512374-7949-42bb-97ed-b49fba4f1c79" alt=""><figcaption></figcaption></figure>

4. Click on Components

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2FC7fLxAFnJlXh7rnd3Ixa%2Fimage.png?alt=media&#x26;token=8ac17f5c-0ce3-4350-b7d2-27d4576827f8" alt=""><figcaption></figcaption></figure>

5. Select Add Component > Get More Components.

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2FrlLdQQSsj9dkhyka3sOh%2Fimage.png?alt=media&#x26;token=3bf3f8f0-f6b7-4cf8-af15-ba89b7322e55" alt=""><figcaption></figcaption></figure>

6. From the list, select Maplytics List Control and click Add.

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2F160OVXFHeM1f2hTCFe9b%2Fimage.png?alt=media&#x26;token=8532ede8-cfd2-4255-b9f4-e0b9298f0f62" alt=""><figcaption></figcaption></figure>

7. Once added, select Maplytics List Control under Components.

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2F0k2Wn97CTwql7o1yjKED%2Fimage.png?alt=media&#x26;token=f16c1293-5272-4b29-b3bc-3d1b7e0802c1" alt=""><figcaption></figcaption></figure>

8. Configure Required Details:

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2FLksVTmNeBk9Vu5vg8dUG%2Fimage.png?alt=media&#x26;token=200ac1aa-4e4d-4483-af37-9735875e67d4" alt=""><figcaption></figcaption></figure>

a. Map Key – Enter the Azure Maps key acquired for mapping services. Based on the Azure Map Key the search and route operations will run on the Maplytics List Control.\
\
b. Latitude & Longitude – Provide the logical names of fields storing latitude and longitude values for the entity. The records will be shown on the map based on the latitude and longitude values from the records.

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2FUU2i8dSk9b0gizsccMiQ%2Fimage.png?alt=media&#x26;token=7636d672-b940-4f58-b5e9-eb30987ff64f" alt=""><figcaption></figcaption></figure>

c. Proximity – Set a default radius search value (between 1 – 2000) when used in Power Pages and Canvas apps.\
\
d. Distance Unit – Choose between Miles or Kilometers as the default unit for searches and route optimization.\
\
e.  Optimize Routes By – Select how routes should be optimized:

&#x20;          i.      Shortest Distance (default): Optimizes based on the shortest travel distance.

&#x20;          ii.      Shortest Time: Optimizes based on the shortest travel time.

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2FanxBCltYhnD9IzC4RUhX%2Fimage.png?alt=media&#x26;token=d581f6ff-039a-49b5-869d-cf66a84bb0f4" alt=""><figcaption></figcaption></figure>

f. Navigate In – Choose the preferred maps for navigation (default: Google Maps). Available options:

&#x20; i.      Google Maps

&#x20; ii.      Apple Maps

&#x20; iii.      Waze Maps

g. Full Address – Enter the logical names of the address-related fields to display on the tooltip card. Separate them with commas in the desired display order.

h. Tooltip Actions – Enter the logical names of activities or actions users can perform from the tooltip card (e.g., to allow appointment creation, enter the logical name for "Appointment"). Separate multiple actions with commas.<br>

9. Click Done after entering all details.
10. Click Save, then Publish to apply the changes
11. Once published successfully, the Maplytics List Control will appear on the configured view.

Maplytics List Control provides the user with the freedom of using Maplytics features right from the view without switching to any other screens. Users can also perform the following Maplytics features within the Maplytics List control. To know about these features in detail, please refer to the respective feature sections in this manual.

<figure><img src="https://3017709171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPnKwzedQAh8ohtXMDq%2Fuploads%2F7E82ao8UgRknvbDYuNc5%2Fimage.png?alt=media&#x26;token=dfb66b39-cae0-4e50-a9db-49e9d332bb14" alt=""><figcaption></figcaption></figure>

{% hint style="info" %} <mark style="color:blue;">**Note:**</mark>&#x20;

·       *Maplytics List Control is supported for Model-driven apps, Power Pages, and Canvas App.*

·       *Latitude and Longitude fields must be present in the view to display the records on the map.*

·       *All the logical names mentioned while configuring the Full Address fields must be present in the view to display the address-related fields on the tooltip card.*

·       *Only the fields that are present in the view will be displayed as details when clicked on pushpin as Tooltip card*.
{% endhint %}


---

# 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.maplytics.com/features/azure-maps-maplytics-list-control.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.
