Tile Layer | ActiveReports 18 .NET Edition

Tile Layer

In This Topic

Show All

Hide All

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

Use the following steps for creating a basic map using the Tile layer. These steps assume that you have added a page layout template to your report and have a data connection in place. See Data Binding in Page/RDLX Reports for more information.

From the toolbox, drag and drop a Map control onto the design surface.
In the Select a Map Template wizard that appears, select the New Map template.
Click the map until the map panes appear.
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.
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.

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 purposes and can't be used by 3rd party applications. 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 ActiveReports.config file to configure embedded Bing tile provider with Application key.

Paste inside the <Configuration></Configuration> tags.	Copy Code
<MapTileServerConfiguration> <Timeout>5</Timeout> <AppID>"Your Application Key"</AppID> </MapTileServerConfiguration>

Caution: The 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 to monitor the usage of this tile server with the Google API Console. Please register with Google account with the billing information to obtain a key.

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

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>

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>

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 ActiveReports.config file to configure embedded MapQuest tile provider with ApiKey.

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>

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.

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 a layer based on any expression or zoom value.
Click OK to close the dialog and go to the preview tab to view the map.

Note: If you are using a 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)

Find devenv.exe.config (the devenv.exe configuration file) in: Program Files (x86)\Microsoft Visual Studio\2019 or 2022\Professional\Common7\IDE

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

On the menu bar, choose Project, Add New Item and then choose the Application Configuration File template.
In the Name text box, enter a name, and then click Add button.

In the configuration file, add this code:

Paste inside the <configuration></configuration> tags.	Copy Code
<system.net> <defaultProxy useDefaultCredentials="true" /> </system.net>

Note: 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.