Configuring and Formatting Bing Maps

Bing Maps allows you to visualize the markers based on the latitude and longitude data.

Figure: Default Bing maps visualization showing markers based on the configured latitude and longitude information

How to get Bing Maps keys

You need to follow these steps to get keys,

1. Go to the Bing Maps Dev Center at https://www.bingmapsportal.com/.

2. Register or sign in using your Microsoft account.

3. Select My keys under My Account.

4. Select the option to create a new key.

5. Provide the required details in the following form,

6. Click the Create button. The created new key will be displayed in the following list. Use this key to authenticate your Bing Maps.

How to enable Bing Maps by configuring the web config file in Enterprise

To enable the bing maps in your enterprise build, you need to follow these steps.

Bold BI version 4.1.36 or later

Open the below mentioned file in your enterprise build location, [Installed_Directory \BoldServices\bi\dataservice\appsettings.json].

Set widget:bing_map:enable key value as true and set your Bing Maps Key in widget:bing_map:api_key in appsettings.json.

Then, launch your build and you find the bing maps in design panel.

Bold BI version below 4.1.36

1. Open the below mentioned file in your enterprise build location, [Installed_Directory\ Bold BI\Dashboard Designer\Web.config]

2. Set widget:bing_map:enable key value as true.

3. Provide your bing maps key here.

Then launch your build and you find the bing maps in design panel.

How to configure the data table to Bing Maps widget

NOTE: Before adding the Bing maps widget to the design layout, make sure to create the data source. You can refer to this section to learn how to create a new data source.

IMPORTANT: To showcase a Bing maps, a minimum requirement of one latitude and one longitude fields are needed.

The following steps explains about data configuration of the Bing maps.

Step 1: Add a bing maps widget to the design canvas

1. Drag and drop the Bing maps control icon from the tool box into design panel. You can find control in tool box by search.

2. Resize the widget as required.

Step 2: Configuring data into the widget

1. Click the Properties icon in the configuration panel.

2. The properties panel of the widget will be displayed as shown in the following screenshot. Now, switch to the ASSIGN DATA tab.

3. The data tab will be opened with available columns from the connected data source.

Location Value

An element can be dragged from measure or dimension section.

Location Name

Drag the elements from the Dimension to Location Name section.

Bing map will render as follows.

You can add more than one value to the Location Name section. The alert message will be shown to enable the drill-down option.

Click Yes to enable the option.

NOTE: If you click No, a single value will be added to the Location Name field(i.e. newly dropped column replace the existing one).

Figure: Bing-map with drilled view of the selected area.

Latitude Section

Bind column by dragging and dropping the element from sections to Latitude.

NOTE:

• The field added in this section will act as a latitude value.

Longitude Section

Drag and drop the elements from sections to Longitude section.

NOTE:

• The field added in this section will act as a longitude value.

Image: Bing maps widget after configuring the mandatory fields.

Address

Drag and drop the elements from sections to Address section. The field added here, will act as a address value.

Bing maps widget, after configuring the Address fields.

Postal Code

Drag and drop the elements from other sections to Postal Code section. The field added here, will act as a postal code.

Image: Bing maps widget after configuring the Postal Code fields.

Marker Tooltip section

Drag and drop the elements from sections to Marker Tooltip section. It will define the marker tooltip value in the bing maps. Also, it is an optional section.

Image: Bing maps widget after configuring the market tooltip field

Marker Image section

Drag and drop the elements from sections to Marker Image section. It will define the marker in the bing maps. Also, it is an optional section.

Image: Bing maps widget after configuring the marker Image field

Step 3(Optional): Settings menu options

You can filter and sort the data displayed in the widget from the settings menu options. To open the settings menu, click the settings icon.

Filtering data

You can use Filters to change the values by selecting the Filter option. For more details, refer to Measure filter and dimension filter.

How to format Bing maps widget

You can format the Bing maps for better illustration of the view that you require using the settings available in the Properties tab.

General settings

Name

This allows you to set title for this Bing maps widget.

Subtitle

This allows you to set subtitle for this Bing maps widget. It is optional.

Description

This allows you to set brief explanation about this Bing maps widget. It is optional.

Basic Settings

Map theme

This allows you to toggle the theme of the bing maps.

1. Road Type

2. Aerial

3. Canvas Dark

4. Canvas Light

5. Gray Scale

Show Zoom Icon

This allow to show the zooming Icons in bing maps.

If you perform zoom in or zoom out using icons or mouse in design mode, then the same zoom level will be maintained in the view mode.

Zoom state in design mode.

Zoom state in view mode.

Map shape

This allows you to toggle the map shapes of the Bing Maps.

1. Choropleth

2. Bubble

Marker Settings

Marker Shape

This allow to change the marker shapes of the bing maps.

1. Circle

2. Diamond

3. Star

4. Triangle

5. Image This allow to upload the various type of Images.

Image: Bing maps widget after applying the marker Image settings

Color

This allows to change the marker color of the bing maps.

Size

This allows to change the marker size of the bing maps.

Advanced Settings

Markers can be customized based on the conditions and the fields by enabling the advance settings check box.

1. Based on measure field

2. Based on dimension field

To Configure Bing maps with address information

You can render the bing maps markers based only on the address information. For that, there are two sections Address and Postal Code added in the field containers section as shown in the following image,

Drag and drop the required fields to the respective field containers to render the bing maps markers. You can drag and drop either the Address field or Postal Code field, or both the fields.

After that configurations

Filter

Act as master widget

This allows you to define the Bing Maps widget as a master widget such that its filter action can be made to listen by other widgets in the dashboard.

Ignore filter actions

This allows you to define this Bing Maps widget to ignore responding to the filter actions applied on other widgets in dashboard.

Enable hierarchical filtering

Using this option, you can enable or disable hierarchical top N filtering. While applying Top N filter with multiple dimension columns, the data returned can be customized based on whether the filtering need to be done as flat or based on the hierarchy of dimension columns added.

When Hierarchical Filter option is enabled, the Top N will be applied for each individual column separately based on the number set for each column.

Container appearance

This section contains the property for bing maps container’s layout.

This allows you to customize the widget container appearance, widget title’s properties and provides options to enable/ disable widget exporting options. For more detailed information, refer to container appearance properties.