Embed a map-enabled report

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

Requirements

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

  • You must be signed in to a valid ArcGIS account with the appropriate user type.
  • To create a map-enabled report in Power BI, you must be signed in to Power BI with a Pro or Premium account. Report consumers must sign in to Power BI to view a report in an embedded environment. If the ArcGIS for Power BI visual contains private data, they must also sign in to ArcGIS.
  • Power BI data used to create the ArcGIS for Power BI map must use latitude and longitude coordinates for locations. If the Location field well contains addresses or standard boundaries, publishing to the web will not work.
  • A published map can contain a maximum of 30,000 locations.
  • You must run the ArcGIS for Power BI publishing precheck before generating an embed code for the report.
  • Consumers must sign in to view embedded reports containing secure content.

Create and check a map-enabled report

Use ArcGIS for Power BI Desktop or the ArcGIS for Power BI service (powerbi.com) to create a map-enabled report.

To check a map-enabled report for embedding, do the following:

  1. Create a report that contains an ArcGIS for Power BI map and save the report.
  2. With the ArcGIS for Power BI visual active, click Settings Settings to view the Settings pane.
    Note:

    If necessary, click Map tools Map tools to expand the toolset.

  3. In the Settings pane, in the Embed and publish check category, click Validate.
    Note:

    You must be signed in to a valid ArcGIS organizational account to see the Embed and publish check section in the Settings pane.

  4. In the Embed and publish check pane, click Run check.

    The check verifies that all requirements for publishing the map have been met, including verifying that Power BI location data is in latitude and longitude coordinates.

  5. Review the message that appears when the check completes.

    Layers that pass all requirements appear with a green checkmark Pass. If an item does not meet the requirements, a red mark Fail appears beside the item. Click Show error details to view information about the error.

  6. Correct errors in the map, save the report, and run the Embed and publish check again.

    When the check completes successfully, a message appears stating that the map has passed and is ready to be published with the report.

Embed a map-enabled report

When you've created and checked your map-enabled report, 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 application.

To embed a map-enabled report to the web, follow these steps:

  1. From the Power BI menu, click File > Publish to Power BI. Alternatively, 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 the report.

    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. To generate a secure embed link, do one of the following:
    • In Reader view, click Share to view the context menu and select Embed report. Choose SharePoint online or Website or portal.
      In Reader view, click the Share button to access the Embed report feature.
    • In Edit mode, click File > EmbedFile > Embed or File > Embed in SharePoint Online.
      In Edit mode, expand the File menu to access the Embed feature.
    Note:

    If you don't see the Publish to web menu options, 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 appears, listing two options that you can use to embed the report in a public website. Do one of the following:

    • To embed a URL in an app, blog article, or other location, copy the link in the first field and paste it 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 field. Optionally, resize the iFrame to fit the page by moving the Resize slider to the right. Paste the code into your web page and publish the page.

The report now appears on the published web page.

To view the embedded content, consumers must sign in to Power BI. If the report contains secure content from ArcGIS, consumers must also sign in to ArcGIS using a valid ArcGIS account.