Unable to render {include} The included page could not be found.

Enabling a maps license

The desktop universal client, Admin console, and Android mobile client will not show location maps without action on your part. ,As a system administrator, follow the procedures in this topic to display location maps on these interfaces. Location maps are required to access floor maps.

Related topics


The following images illustrate an example in which a map is not shown if a maps license is not enabled.

Contact area with map block shown

Contact area with map block hidden

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 do any of the following:
  • 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 either a production or a 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 in the Google documentation.

For information about obtaining a license, see Obtaining an API key in the Google documentation.

BMC Digital Workplace and 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 enable the Google Maps license

  1. Obtain a license key as explained in Options for obtaining a Google Maps license
    The license key is also referred to as a Client ID.

  2. From the BMC Administration Console (http://server:port/ux/admin), select Configuration > Map API.

  3. Enter the following information, and then click Save:

    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. Restart the Apache Tomcat service.

Google Maps License information

Where to go from here

Setting up locations

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


  1. Marek Ceizel

    Hi, Can you confirm that the SmartIT / MyIT server must have internet connection to activate / use the Google Maps ? thanks Marek

    Oct 08, 2018 05:47
  2. Olga Kutetska

    Hello, Marek!

    Yes, the server must have internet connection.

    Oct 16, 2018 11:29