This documentation supports the 22.1 version of BMC Helix Digital Workplace Basic and BMC Helix Digital Workplace Advanced. Icons distinguish capabilities available only for the Advanced and External license levels. For more information, see License types and features.

Adding a Google Maps license key

As an administrator, use Google Maps to help your end users locate assets and resources such as conference rooms, printers, and copiers, and also get directions. To be able to display location-based floor maps with assets in the end user console, you must obtain a Google Maps license and add the license information in the Map API configuration settings in the Admin console.    

The following images illustrate an example of a user profile page in which a map is shown:

Options for obtaining a Google Maps license

You must obtain a license from Google. Contact Google directly to arrange an API licensing option based on your expected usage. You can perform any of the following tasks:

  • Generate your own license key on the Google Developer's Console. 
    From this console, you can also add more host URLs as needed.
  • Register with Google for a production or nonproduction license key. (You can use a nonproduction license key for testing, development, and training.)
  • Use a cryptographic signing key to generate unique signatures for your web service requests. See Digital signatures Open link in the Google documentation.

For information about obtaining a license, see Obtaining an API key Open link in the Google documentation. You must also enable the Geocoding Open link  and  Geolocation Open link  APIs.


BMC Helix Digital Workplace and BMC Helix ITSM: Smart IT can share the same Google Maps API license. Register the server location (country) and host URL of both applications under the same account. Then, enable the license in the appropriate server configuration files.

To add the Google Maps license key

  1. Obtain a license key (also referred to as a Client ID).

  2. From the BMC Helix Digital Workplace Admin console (http://server:port/dwp/admin), select Configuration > Map API.

  3. Enter the following information:

    FieldDescriptionValue in production environmentValue in a nonproduction environment
    Google Maps API KeyEnter the API key.Leave blank.

    API key that you received from Google.

    Google Maps API Client IDEnter the license key.License key that you received from Google.Leave blank.
    Google Maps API Encryption Key(Optional) Your welcome letter from Google includes a cryptographic signing key, which you can use to generate unique signatures for your web service requests.Cryptographic signing key that you received from Google.Cryptographic signing key that you received from Google.
  4. Click Save.

Where to go from here

Setting up locations

Was this page helpful? Yes No Submitting... Thank you