ActiveReports 14
ActiveReports 14 User Guide / How To / Page Report/RDL Report How To / Report Controls / Work with Map / Work with Layers / Use a Tile Layer
In This Topic
    Use a Tile Layer
    In This Topic

    A Tile layer displays the virtual earth tile background on the map.

    Use the following steps for creating a basic map using the Polygon layer. These steps assume that you have added a page layout template to your report and have a data connection in place. See Quick Start and Connect to a Data Source for further information.

    1. From the Visual Studio toolbox, drag and drop a Map control onto the design surface.
    2. In the Select a Map Template wizard that appears, select the New Map template.
    3. Click the map until the map panes appear.
    4. Right click inside the area labeled "Right click to add the new layer." and select Add Tile Layer. This adds a tile layer to the map and opens the Map Tile Properties dialog.

    5. In the Map Tile Properties dialog that appears, on the General page, set the layer name and choose its Source and Type. The default values in these fields also work fine.
    6. In the Provider property, choose one from the following supported tile providers:
      • Bing: The Microsoft Bing Map server offers static map images. This requires an Application key for authentication. The default key provided by ActiveReports is for demo purpose and can't be used by 3rd party applications. In order to obtain a Bing Map Key, see HowTo - Create a Bing Map Account and HowTo - Get a Bing Map Key.
        Note: After generating the key, add the following script in the Grapecity.ActiveReports.config file to configure embedded Bing tile provider with Application key.

        Script

        Paste inside the <Configuration></Configuration> tags.
        Copy Code
        <MapTileServerConfiguration>
           <Timeout>5</Timeout>
           <AppID>"Your Application Key"</AppID>
        </MapTileServerConfiguration>
        
      • Caution: The Grapecity.ActiveReports.config file should always be placed in the same folder as the EndUserDesigner.exe file for displaying a Bing tile layer on a Map.
      • Google: The Google Map server creates your map tiles based on URL parameters sent through a standard HTTP request that returns the map tiles as an image. It is necessary to set the API key in order to monitor usage of this tile server with the Google API Console. Please register with Google to get the API key.

        Note: After obtaining the key, add the following script in the Grapecity.ActiveReports.config file to configure embedded Google tile provider with ApiKey.

        Script

        Paste inside the <Configuration></Configuration> tags.
        Copy Code
        <!-- Configure embedded Google tile provider with API Key -->
        <MapTileProvider Name="Google" DisplayName="Google" >
            <Settings>
              <add key="ApiKey" value="API Key" />
              <add key="Timeout" value="5000" />
            </Settings>
        </MapTileProvider>                                                                        
        
      • CloudMade: The CloudMade tile server allows you to access it through the HTTP Tile API. The URL structure for this API is straightforward, and is instantly recognizable to anyone familiar with the OpenStreetMap tile numbering convention. To use a CloudMade Tile server you require an API key for authentication which can be obtained by registering at CloudMade.
        Note: After generating the key, add the following script in the Grapecity.ActiveReports.config file to configure embedded CloudMade tile provider with ApiKey.

        Script

        Paste inside the <Configuration></Configuration> tags.
        Copy Code
        <!-- Configure embedded CloudMade tile provider with ApiKey -->
        <MapTileProvider Name="CloudMade" DisplayName="CloudMade Tiles Provider">
            <Settings>
              <add key="ApiKey" value="API Key" />
            </Settings>
        </MapTileProvider>
        
      • MapQuest: The MapQuest tile server provides the tiles in a format similar to Google. This tile server requires an API Key for authentication which can be obtained by registering at MapQuest
        Note: After generating the key, add the following script in the Grapecity.ActiveReports.config file to configure embedded MapQuest tile provider with ApiKey.

        Script

        Paste inside the <Configuration></Configuration> tags.
        Copy Code
        <!-- Configure embedded MapQuest tile provider with ApiKey -->
        <MapTileProvider Name="MapQuest" DisplayName="Map Quest Tiles Provider">
            <Settings>
              <add key="ApiKey" value="API Key" />
              <add key="Timeout" value="3000" />
            </Settings>
        </MapTileProvider>
        
        
      • OpenStreetMap: The OpenStreetMap server provides the tiles in an index based format. This tile server provides only the roadmap and returns fixed size images (256x256). Before using the OpenStreetMap server, go through the Copyright and License and Tile usage policy pages.
    7. Go to the Visibility page of the dialog and make sure the layer visibility is set to Show. You can also select options to show or hide layer based on any expression or zoom value.
    8. Click OK to close the dialog and go to the preview tab to view the map.

    Note: If you are using proxy server connection to see the map tile images, you need to set credentials for the proxy server in the application config file for authentication. To use your default proxy server credentials, you can do the following:

    For Visual Studio Designer (IDE)

    1. Find devenv.exe.config (the devenv.exe configuration file) in: Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\IDE
    2. In the configuration file, find the <system.net> block, and add this code:
      Paste inside the <system.net></system.net> tags.
      Copy Code
      <defaultProxy useDefaultCredentials="true" />
      

    For Visual Studio Application

    1. On the menu bar, choose Project, Add New Item and then choose the Application Configuration File template.
    2. In the Name text box, enter a name, and then click Add button.
    3. In the configuration file, add this code:
      Paste inside the <configuration></configuration> tags.
      Copy Code
      <system.net>
      <defaultProxy useDefaultCredentials="true" />
      </system.net>
    Note: Grapecity.ActiveReports.config file should be kept inside the project Debug folder and added to a Visual Studio project for displaying a Tile layer on a Map in any Viewer control.
    See Also