MicroStrategy ONE

Setup for integration with Google Maps

Install the GIS Connector for Google Maps

When you install MicroStrategy, select the Install GIS Connectors checkbox under MicroStrategy Web Universal. This places the MicroStrategy GIS Connector (plug-in) for Google Maps in the GISConnectors folder in the MicroStrategy installation directory. If you do not install the connector during the initial installation of MicroStrategy, you can install it later by repairing the installation and choosing to Install GIS Connectors.

Obtain a Google Maps license and register your domain

To obtain a Google Maps API Premier key and register your domain with Google, access Google Maps API and follow the instructions on the web site. Your Google Maps API Premier key is valid for a single directory or domain.

Copy the plug-in and configure the Google Maps visualization

When you configure the plug-in and copy it to MicroStrategy Web, the Google Maps visualization is added to the list of visualizations that can be used in a dashboard or document.

  1. Open the GISConnectors/Map folder inside your MicroStrategy installation directory, then open the folder containing the Google Maps visualization plug-in for your environment:
    • J2EE environment: ConnectorForMap
    • .NET environment: ConnectorForMap_ASP
  2. Copy the ConnectorForMap plug-in folder for your environment and paste it in the plugins folder of your MicroStrategy Web installation directory.
  3. Expand the copied ConnectorForMap plug-in folder, and navigate to WEB-INF/xml/.
  4. Open the mapConfig.xml file and do the following:
    1. Configure your Google Maps API key

      • If you are using the Google Maps API Premier product, add your Google Maps API key between the <mk> and </mk> tags, in place of InvalidPremierKey shown in bold in the code sample below. This is the key you got when you registered your domain with Google.

        Copy
        <gc>
        <mk>InvalidPremierKey</mk>
        </gc>

      • If you are using the standard Google Maps API instead of the Google Maps API Premier product, set the isPremier attribute of the <mk> element to "false".

        Copy
        <gc>
        <mk isPremier="false">InvalidPremierKey</mk>
        </gc>

    2. The channel feature allows you to view your usage reports for maps by channel on your Google Enterprise Support Portal. If you want to use this feature to track usage across different applications using the same client ID, add a <channel> tag as a child of the <gc> tag. Add a correctly formatted parameter in place of ChannelParam. See the Google developer web site for instructions on how to format the channel parameter.

      Copy
      <gc>         
      <mk isPremier="true">PremierKey</mk>
      <channel>ChannelParam</channel>
      </gc>

    3. Save the modified mapConfig.xml file.
  5. Restart your web server to apply the changes.

Access Google Maps visualizations from a dashboard

  1. Open a dashboard with a dataset that includes geo attributes.
  2. In the top toolbar, click Insert Visualization.
  3. Choose Map > Map.
  4. If the Base map type is ESRI, open the Format panel.
  5. From the Map style drop-down, select Google.
  6. In the Datasets panel, double-click geo attributes and metrics to add them to the visualization.