Add geospatial components to your app (Preview)

[This topic is pre-release documentation and is subject to change.]

You can add a number of geospatial components to your canvas app to support scenarios that involve mapping locations and addresses.

Components are groups of controls that can answer the need for a specific scenario. You can read more about components and how to build your own in the Power Apps developer library.

The following prebuilt components can be used for geospatial and mapping scenarios:

Prerequisites

  1. An admin must enable the geospatial features in the Power Platform admin center for the environment. This requires reviewing and agreeing to specific terms of service.

  2. Enable the geospatial features for each app.

    Important

    The components require the default Organizations data source to be present. This data source is included whenever you insert the components into an app, but if you manually delete it you'll need to add it before the components will work:

    1. With the component selected, go to the Data sources tab on the side navigation menu.
    2. In the search field, enter Organizations, and then select the data source that appears. This will add it to the component.

Enable the geospatial features for the environment

Before you can use geospatial features in your apps, an admin must enable access to the features for the environment where you want to create your app.

The geospatial features require additional terms of use that must be reviewed and agreed to.

  1. Open the Power Platform admin center.

  2. On the Environments tab, select the environment you want to use for your apps, and then select Settings from the top menu.

    Environment selected in the Power Platform admin center

  3. Expand Product, and then select Features.

    Screenshot of environment settings with Features selection highlighted

  4. Under Geospatial services (preview), set the toggle switch to On. A terms of service notice will appear. Read through the terms of service, and if you agree, select the checkbox I agree to the terms of service, and then select Enable.

    Screenshot of the terms of service

    Important

    You must read and agree to the terms of service before you can use geospatial features.

    The following are the terms of service:

    These features use mapping capabilities that are powered by a third party, TomTom(tm), and operate outside your tenant's geographic region, compliance boundary, or national cloud instance.

    Microsoft shares the address and location queries with TomTom(tm). The name of the customer or end user who entered the query is not shared.

    This feature is non-regional and the queries you provide may be stored and processed in the United States or any other country in which Microsoft or its subprocessors operate.

    Additional licensing requirements might be required to enable this feature.

    Screenshot of the geospatial services toggle switch to On

    Note

    Requests sent between TomTom(tm) and the Azure Maps service are not exposed over the public Internet.

    Requests between apps you create with the component and the Azure Maps service are sent over HTTPS.

  5. Select Save at the bottom of the settings page.

    Screenshot of the Save button

Enable the geospatial features for each app

  1. Open the app for editing in Power Apps Studio at https://create.powerapps.com.

  2. Select File from the top menu.

    Select File

  3. Go to the Settings tab, select Advanced settings, and scroll down to find the Geospatial features option. Set the option to On.

    Set the Geospatial features switch to on

  4. Return to editing your app by selecting the back arrow icon.

    Select the back arrow icon

  5. Open the Insert pane to see the geospatial components:

    • Address input is under Input
    • Map is under Media

    See the address input component under Input

    See the map component under Media

Next steps

Start installing the components in your apps:

  • Visualize and interpret location data with the Interactive map component.
  • See dynamic address suggestions as you type with the Address input component.