Map module

Article
08/12/2022

This article covers map modules and describes how to configure them in Microsoft Dynamics 365 Commerce.

A map module shows the locations of stores on an interactive map that is rendered by using the Bing Maps V8 Web Control. A Bing Maps API key is required and must be added to the shared parameters page in Commerce headquarters. Map modules provide different views, such as Road, Aerial, and Streetside, that users can select to view map locations. They also allow for interactions such as zooming and using the user's location.

A map module works in conjunction with the store selector module to determine the geographic locations of stores that must be rendered on a map. Store selector and map modules interact when a user selects a store in one of those modules on a site page. Map modules can be extended for other scenarios, beyond interaction with store selector modules. However, module customization is required.

Note

The map module is available in the Dynamics 365 Commerce 10.0.13 release.

The following image shows an example of a map module that is used on a store locations page.

Example of a store selector module.

Module properties

Property name	Value	Description
Heading	Text	The heading for the module.
Pushpin options: Default icon	Image	The pushpin symbol image to use for stores that are shown on a map.
Pushpin options: Active icon	Image	The pushpin symbol image to use for a store that is selected on a map.
Pushpin options: Default icon color	Character string	The text or hexadecimal value for the color of pushpin symbols on a map.
Pushpin options: Active icon color	Character string	The text or hexadecimal value for the color of selected pushpin symbols on a map.
Show index	True or False	If this property is set to True, every pushpin symbol that indicates a store will show an index. This index will match the index in the list view that the store selector module shows.

Add allowed mapping URLs to a site's content security policy directives

For the maps module to interact with Bing Maps, you must ensure that the following mapping URLs are allowed per your site's content security policy (CSP). This setup is done in Commerce site builder, by adding allowed URLs to various site CSP directives (for example, img-src). For more information, see Content security policy.