Embedding maps in BI platforms


Embedding Builder maps into BI platforms like Looker Studio, Tableau, or Power BI is a straightforward way to add interactive maps to your reports and dashboards. This guide shows you how to do just that, making your data visualizations more engaging and informative.

Resources for this tutorial:

In this tutorial, we're providing you with an existing Builder map as a hands-on example to guide you through the process. This example map highlights historic weather events. If you're interested in creating a similar map, this tutorial is for you.

Step-by-Step Guide:

In this guide, we'll walk you through:

Accessing your map URL and embed code

To access your map's URL and/or embed code, first ensure that your map has been shared — either within your organization, with specific groups, or publicly. After sharing the map, you can proceed with the following steps:

  1. Map Link: This direct URL to your map can be quickly obtained in two ways:

    • Through a quick action from the 'Share' button.

    • Within the sharing modal in the left bottom corner.

  2. Embed code: This is specifically available within the sharing modal:

    • Navigate to the sharing settings of your map.

    • Look for the "Developers and embedding" section. Here, the embed code is provided, allowing you to copy and paste it into the HTML of your site or application for seamless embedding.

Embedding maps in BI platforms

Embedding Builder maps into BI platforms, which often lack geospatial support, can significantly enhances data visualization and analysis capabilities. By incorporating interactive maps, users can unlock spatial insights that are often hidden in traditional BI data views, allowing for a more intuitive understanding of geospatial patterns, trends, and relationships.

We'll explore how to embed Builder maps into the following platforms:

Embed a map in Looker Studio

Embedding a Builder map in Looker Studio is seamless with the URL embed functionality. Here’s how you can do it:

  1. On the right, in the properties panel, select the SETUP tab.

  2. Enter the Builder map URL in the External Content URL field.

Once embedded, you have the freedom to further refine your Looker Studio report. This can include adding charts, implementing filters, organizing content with containers, and enhancing the overall aesthetics of your report.

To see an example of a Looker Studio report featuring an embedded public Builder map, explore this report. And for a visual walkthrough, check out below GIF displaying the example report in action.

Embed a map in Power BI

In Power BI, you can embed a Builder map on your dashboard following these steps:

  1. Start by setting up a new dashboard within Power BI.

  2. Make sure you are in editing mode to make changes to your dashboard.

  3. Look for the option to add a Web Content Tile to your dashboard.

  4. Configure the Web Content Tile:

    • Set a title for your tile to indicate what the map represents.

    • Include the embed code for your Builder map in the tile configuration:

<iframe width="640px" height="360px" src="https://clausa.app.carto.com/map/5d942679-411f-4ab7-afb7-0f6061c9af63"></iframe>
  1. Click "Apply" to finalize the tile's setup.

After these steps, your Builder map will be displayed as a Web Content Tile within your Power BI dashboard.

Embed a map in Tableau

Embedding a URL, such as a web map or any other web content, in Tableau is straightforward using the Web Page object in Tableau Dashboard. Here’s how you can do it:

  1. Open Tableau and go to the dashboard where you want to embed the URL.

  2. Select Web Page from the objects list at the bottom of the screen.

  3. Drag the Web Page object to your dashboard workspace.

  4. Enter the URL in the dialog box that appears. This is where you would paste the URL you wish to embed, such as your Builder map link: https://clausa.app.carto.com/map/5d942679-411f-4ab7-afb7-0f6061c9af63

  5. Click OK. Tableau will load the web content specified by the URL directly within the dashboard area you’ve selected.

Embed a map in Google Sites

Embedding a URL in a Google Sites allows you to integrate external web content directly into your site. To do so, follow these steps:

  1. Navigate to the Google Site where you want to embed the URL.

  2. Make sure you are in edit mode. You can enter edit mode by clicking on the pencil icon or the Edit button, depending on your version of Google Sites.

  3. Look for the Insert menu on the right side of the screen. Under this menu, you will find various elements you can add to your page. Click on Embed.

  4. in the Embed prompt, enter the embed code of your map:

<iframe width="640px" height="360px" src="https://clausa.app.carto.com/map/5d942679-411f-4ab7-afb7-0f6061c9af63"></iframe>

You can enhance your Google Site by adding further components such as new pages, text, logos, etc. As per below example: https://sites.google.com/cartodb.com/embedtest?usp=sharing

Last updated