Embed a map-enabled report

Note:

Some workflows may require specific privileges. For more information about user types, roles, and privileges, see the Accounts topic.

To use the content sharing features in ArcGIS for Power BI, your Microsoft 365 account should include a Power BI Pro or Premium plan with capabilities to publish reports. Users without this plan cannot embed or publish reports to the web.

You can embed a map-enabled ArcGIS for Power BI report containing private, secure, or proprietary ArcGIS data in a secure website or app. Viewers of the report must sign in to an ArcGIS account to view it. See Content sharing for general information about sharing ArcGIS content.

Sharing reports containing private, secure, or proprietary data requires viewers to sign in to their ArcGIS account. If the report contains public data only, see the Publish a map-enabled report to the web workflow.

After you create a map-enabled report, use the Publish to web option to embed it in a secure website or app outside the Microsoft Power BI environment. Although users typically use Power BI Desktop to create reports, this workflow is also available in the Power BI service (powerbi.com).

Requirements

To use the Publish to web option to embed a map-enabled report, the following requirements must be met:

  • Power BI data used to create the ArcGIS for Power BI map must use latitude and longitude coordinates for locations or Esri JSON in the Location field well. If the Location field well contains addresses or standard boundaries, you can't publish to the web.
  • You must be signed in to a valid ArcGIS account with a user type and role that has been granted appropriate permissions by your account administrator to publish content.
  • Your Microsoft 365 account should include a Power BI Pro or Premium plan with capabilities to publish reports. Viewers of the report must sign in to Microsoft Power BI. If the ArcGIS for Power BI visual contains private data sourced from ArcGIS or an ArcGIS organization, report viewers must also sign in to an ArcGIS account.
  • A published map can contain a maximum of 30,000 locations.
  • You must run the ArcGIS for Power BI publishing check before generating an embed code for the report.

Create and validate a map-enabled report

Use Power BI Desktop or the Power BI service (powerbi.com) to create a map-enabled report. Before you can embed the report, run the embed and publish validation in the ArcGIS for Power BI visualization to ensure that all requirements are met.

To create and validate a map-enabled report for embedding in a website or app, complete the following steps:

  1. Sign in to your ArcGIS account and create and save a Microsoft Power BI report that includes an ArcGIS for Power BI map.
  2. From the map tools, click Settings Settings.
  3. Click the Settings tab Settings.
  4. In the Embed and publish to web category, click Validate.

    Note:
    This category only appears on the Settings tab when you are signed in.

    The check verifies that all requirements for embedding the map have been met, including the following:

    • Power BI location data is in latitude and longitude coordinates.
    • The map contains only publicly accessible data from ArcGIS.
    • No layers contain secured or premium content.

  5. Review the message that appears when the check is complete.

    • Items that meet the requirements appear with a green check mark requirements met.
    • Items that do not meet the requirements appear with a red mark requirements not met.
    • Click Show error details to view information about an error, if applicable.

  6. Correct any errors in the map, save the report, and run the validation again.

    When the process completes successfully, a message appears indicating that the map has passed validation and can be embedded with the report.

Embed the validated map-enabled report

Once you create and validate the map-enabled report, you can publish it to the Power BI platform. The report must be in the Power BI service (powerbi.com) to enable embedding. You generate an embed link associated with the report and copy the resulting code to your site or app.

To embed a map-enabled report, complete the following steps:

  1. From the Power BI menu, click File > Publish to Power BI, or click the Publish button on the Power BI ribbon.
    Note:

    You can also manually update the .pbix file to the Power BI service.

  2. In the Publish to Power BI pane, choose My Workspace, and click Select.

    When the report is successfully published, a confirmation message appears.

  3. Close Power BI Desktop.
  4. Open the report in the Power BI service and save it.

    You must open the report in the Power BI service and save the report before you can publish it to the web or embed it in a website, whether you're working with a new or existing report. This allows ArcGIS for Power BI to verify that the requirements for publishing or embedding are met.

  5. Generate a secure embed link, by doing one of the following:
    • In reading view, click Share > Embed report > SharePoint online or Website or portal.

      Embed report options from the Share menu

    • In edit mode, click File > Embed or click File > Embed in SharePoint Online.

      Embed options from the File menu

    Note:
    If the Embed options are hidden, contact your Power BI administrator to request permission to create embed codes.

  6. In the Secure embed code pane, click Create embed code.

    When the embed code is successfully generated, a confirmation message appears listing two options for embedding the report in a public website.

  7. Embed the report by doing one of the following:
    • To embed the URL in an app, blog article, or other location, copy the link from the first text box into the app or body of the article.
    • To embed the report in a SharePoint site or web page, copy the iframe code from the second text box to the web page and publish the page. You can resize the iframe to fit the page by moving the Resize slider to the right before you copy it to the web page.

    The report appears on the published web page.

  8. To view the embedded content, viewers must sign in to Power BI. If the report contains secure content from ArcGIS, they must also sign in to an ArcGIS account.