Skip to main content

Setup Maps in Apps

Maptaskr Power Maps can be added into any Model-Driven Power App - whether it’s a Dynamics 365 application such as Sales, Field Service, or Customer Service, or a custom app built on the Power Platform. This flexibility lets you visualise geospatial data directly within your business processes.

This page covers three common ways to embed maps:

  • Adding a map control to a record form
  • Adding a map control as a dashboard
  • Adding a map control to a canvas app
Best practice

For maintainability, add Maptaskr components into a dedicated solution instead of editing the default solution directly.
This makes it easier to migrate or reuse your configuration across development, test, and production environments.
See Microsoft’s guide: Create a solution.

Adding a map control to a record form​

note

The examples below use the Account form for demonstration. In your environment, apply the same process to whichever record form is most relevant for your use.

Adding a map control to a form is best when you want to embed geospatial context against a single record type—for example, showing the location of an Account, Contact, or Work Order directly within its record form. This makes it easy for users to see the geographic context of an individual record while they’re working with it.

  1. Go to make.powerapps.com.

  2. Open the form where you want to add the map control.

  3. Navigate to Components → More components.

  4. Check for Maptaskr components:

    • If none are listed, click Get more components.

  5. Search for MaptaskrPowerMapPCF and add it to your components list.

    Adding a new component

  6. Select the newly added component.

  7. Configure map settings:

    FieldDescription
    Table ColumnThe column where shapes are stored. Create a new field in your Dynamics table with format “[Table Name] Shapes” (Single line of text). Add this field to any table where the map control is required, and assign the PCF control to it.
    Profile IDThe ID of your selected configuration profile (found top-left).
    ParametersUsed to apply filters to the provider API.
    Design Width & HeightCSS properties to adjust the map’s dimensions.

  8. Hide the field label for a cleaner interface.

Inset Map PCF Control

  1. Save and publish your changes.

Adding a map control to a dashboard​

Best for aggregating and visualising data across multiple records.

  1. Go to make.powerapps.com.

  2. Open the Dashboard where you want to add the map control by clicking the edit icon.
    Select Edit Dashboard

  3. Select List.

  4. Choose record type Maptaskr Core Configs. Use the default Active Maptaskr Core Configs view.

  5. Select Add.

  6. Select the newly added component and choose Edit Component.

  7. Under Controls, select Add Control.

  8. Find MaptaskrPowerGrid and select it.

  9. Select Add.

  10. Assign web, phone, and tablet to the new control.

  11. Configure map settings:

    FieldDescription
    Is Control Full ScreenSet to true/false.
    Profile IDTaken from your selected configuration profile.
    Parameters (optional)Used to filter provider API responses.
    Design Width & HeightSets the map’s dimensions.
Dynamic Profile ID

You can set the Profile ID dynamically with a small JavaScript expression when configuring the PCF control. This lets different users (or contexts) load different map profiles without duplicating forms.

Simple ternary example

if(userRole === '[roleId]'){'[PROFILE_ID_1]'} else {'[PROFILE_ID_1]'};

Multi-branch example

if (userRole === '[roleId]' && address1_city === 'APAC') {
   '[PROFILE_ID_APAC]';
} else if (userRole === '[roleId2]') {
   '[PROFILE_ID_SERVICES]';
} else {
   '[PROFILE_ID_DEFAULT]'
};

Available variables: Any form attribute (entity field) and user details exposed on the page. To inspect them, open the browser dev tools (F12) while the map is loaded—two console tables are logged: one for form attributes and one for user info.

Guidelines:

  • Return a valid profile ID that exists in your Config Manager.
  • Keep logic fast and side‑effect free (just compute a string).
  • Prefer explicit returns for readability in more complex conditions.

  1. Select Add.

  2. Save and Close.

  3. Save and Publish your changes.

Adding a map control to a canvas app​

note

The examples below use a Maptaskr Custom App for demonstration. In your environment, apply the same process to whichever canvas app you are configuring.

Canvas apps are the most flexible option. Use this approach when you want to build a lightweight, highly customised app that integrates maps alongside other tailored UI elements.
This is especially useful for mobile-first scenarios or task-specific apps where you control every aspect of the layout.

  1. Go to make.powerapps.com.

  2. Locate your app (Apps in the left panel).

  3. Open it for editing in Power Apps Studio.

  4. From the Insert panel, select Get more components.

  5. Select Code and search for MaptaskrPowerCanvas.

  6. Import the component.

  7. Drag and drop it into your canvas.
    Add new canvas app component

  8. Select a table for the canvas app.

  9. Configure component properties:

    FieldDescription
    MaptaskrCoreCanvas(Items)Use Maptaskr Core Configs.
    ViewsLeave as none.
    Is Control Full ScreenTrue/false.
    Profile IDTaken from your selected configuration profile.
    ParametersApply provider-specific parameters.
    WidthControl width (if not fullscreen).
    HeightControl height (if not fullscreen).

  10. Save and publish your changes.

Next Steps​

Once your maps are embedded, you can enhance them further by configuring Profiles, Layers, and Providers to control what data is displayed and how it appears.
See: Configuration Overview.