Add a Custom Tile Provider

Show All

Hide All

You can add and configure a Custom Tile Provider in the Map control using the IMapTileProvider and IMapTile interfaces.

The IMapTileProvider interface contains detailed settings that are required to communicate with the tile server, whereas the IMapTile interface represents a single tile of a Map's tile layer that fetches the tile image based on the configurations in the IMapTileProvider interface.

Adding a custom tile provider also requires making some modifications in the Grapecity.ActiveReports.config file. Follow these steps to learn how to set a custom tile provider:

Create a Class Library Project, for example MyClassLib, in Visual Studio.

Add a new Class to the project and name the class, for example, MyTileProvider. You may add functions and features to this class for getting the Tile images based on your tile server settings and details. This class serves as the interface between your Map control and your custom tile server. Replace the existing code with the following in the MyTileProvider class to implement the IMapTileProvider interface.

VB code. Paste on TOP	Copy Code
Imports System Imports System.Collections.Specialized Imports GrapeCity.ActiveReports.Extensibility.Rendering.Components.Map

VB code. Paste BELOW the Imports statements	Copy Code
Namespace MyClassLib Public Class MyTileProvider Implements IMapTileProvider ' Tile provider settings, like ApiKey, Language, Style and etc. Public Property Settings() As NameValueCollection ' Add your code here. End Property ' Get instance of tile by specifying tile coordinates and details. Public Sub GetTile(key As MapTileKey, success As Action(Of IMapTile), [error] As Action(Of Exception)) ' Add your code here. End Sub End Class End Namespace

VB code. Paste BELOW the Imports statements

Copy Code

Namespace MyClassLib
   Public Class MyTileProvider Implements IMapTileProvider
        ' Tile provider settings, like ApiKey, Language, Style and etc.
        Public Property Settings() As NameValueCollection
        ' Add your code here.
        End Property
        ' Get instance of tile by specifying tile coordinates and details.
        Public Sub GetTile(key As MapTileKey, success As Action(Of IMapTile), [error] As Action(Of Exception))
        ' Add your code here.
        End Sub
    End Class 

End Namespace

C# code. Paste on TOP	Copy Code
using System; using System.Collections.Specialized; using GrapeCity.ActiveReports.Extensibility.Rendering.Components.Map;

C# code. Paste BELOW the Using statements	Copy Code
namespace MyClassLib { public Class MyTileProvider :IMapTileProvider {// Tile provider settings, like ApiKey, Language, Style and etc. public NameValueCollection Settings { get; private set;} // Get instance of tile by specifying tile coordinates and details. public void GetTile(MapTileKey key, Action<IMapTile> success, Action<Exception> error); // Add your code here. } }

C# code. Paste BELOW the Using statements

Copy Code

namespace MyClassLib
{
    public Class MyTileProvider :IMapTileProvider
    {// Tile provider settings, like ApiKey, Language, Style and etc.
    public NameValueCollection Settings { get; private set;}
    // Get instance of tile by specifying tile coordinates and details.
    public void GetTile(MapTileKey key, Action<IMapTile> success, Action<Exception> error);
    // Add your code here.
    }
}

Add a new Class to the project and name the class, for example, MyMapTile. Replace the existing code with the following in the MyMapTile class to implement the IMapTile interface.

VB code. Paste on TOP	Copy Code
Imports System.IO Imports GrapeCity.ActiveReports.Extensibility.Rendering.Components.Map

VB code. Paste BELOW the Imports statements	Copy Code
Namespace MyClassLib Public Class MyMapTile Implements IMapTile ' Gets the tile identifier Public Property Id() As MapTileKey ' Add your code here End Property ' Gets the tile image stream. Public Property Image() As Stream ' Add your code here. End Property End Class End Namespace

VB code. Paste BELOW the Imports statements

Copy Code

Namespace MyClassLib
   Public Class MyMapTile Implements IMapTile
       ' Gets the tile identifier 
       Public Property Id() As MapTileKey
       ' Add your code here
       End Property
       ' Gets the tile image stream.
       Public Property Image() As Stream
       ' Add your code here. 
       End Property     
   End Class
End Namespace

C# code. Paste on TOP	Copy Code
using System.IO; using GrapeCity.ActiveReports.Extensibility.Rendering.Components.Map;

C# code. Paste BELOW the Using statements	Copy Code
namespace MyClassLib public class MyMapTile : IMapTile { // Gets the tile identifier. public MapTileKey Id { get; private set; } // Gets the tile image stream. public Stream Image { get; private set; } // Add your code here. } }

C# code. Paste BELOW the Using statements

Copy Code

namespace MyClassLib
   public class MyMapTile : IMapTile
   {   // Gets the tile identifier.
       public MapTileKey Id { get; private set; }
       // Gets the tile image stream.
       public Stream Image { get; private set; }  
       // Add your code here.     
    }
}

Add another Class to the project and name the class, for example, WebRequestHelper. Replace the existing code with the following in the WebRequestHelper class to implement the loading of raw website data into the System.IO.MemoryStream class.

VB code. Paste on TOP	Copy Code
Imports System.IO Imports System.Net

VB code. Paste BELOW the Imports statements	Copy Code
Namespace MyClassLib Module StringExtensions Public Sub CopyTo(ByVal input As Stream, ByVal output As Stream) 'Add your code here End Sub Private Function InlineAssignHelper(Of T)(ByRef target As T, value As T) As T 'Add your code here End Function End Module Friend NotInheritable Class WebRequestHelper Private Sub New() End Sub ' Load raw data into MemoryStream from specified Url. Public Shared Function DownloadData(url As String, timeoutMilliseconds As Integer) As Stream 'Add your code here End Function 'oad raw data into MemoryStream from specified Url. Public Shared Sub DownloadDataAsync(url As String, timeoutMilliseconds As Integer, success As Action(Of MemoryStream), [error] As Action(Of Exception)) 'Add your code here End Sub Private Shared Function InlineAssignHelper(Of T)(ByRef target As T, value As T) As T 'Add your code here End Function End Class End Namespace

VB code. Paste BELOW the Imports statements

Copy Code

Namespace MyClassLib
    Module StringExtensions
        Public Sub CopyTo(ByVal input As Stream, ByVal output As Stream)
        'Add your code here    
        End Sub
        Private Function InlineAssignHelper(Of T)(ByRef target As T, value As T) As T
        'Add your code here    
        End Function
    End Module
    Friend NotInheritable Class WebRequestHelper
        Private Sub New()
        End Sub
        ' Load raw data into MemoryStream from specified Url.
        Public Shared Function DownloadData(url As String, timeoutMilliseconds As Integer) As Stream
        'Add your code here   
        End Function
        'oad raw data into MemoryStream from specified Url.
        Public Shared Sub DownloadDataAsync(url As String, timeoutMilliseconds As Integer, success As Action(Of MemoryStream), [error] As Action(Of Exception))
        'Add your code here   
        End Sub
        Private Shared Function InlineAssignHelper(Of T)(ByRef target As T, value As T) As T
        'Add your code here   
        End Function
    End Class
End Namespace

C# code. Paste on TOP	Copy Code
using System.IO; using System.Net;

C# code. Paste BELOW the Using statements	Copy Code
namespace MyClassLib { internal static class WebRequestHelper { // Load raw data into MemoryStream from specified Url. public static Stream DownloadData(string url, int timeoutMilliseconds) {//Add your code here } public static void DownloadDataAsync(string url, int timeoutMilliseconds, Action<MemoryStream> success, Action<Exception> error) {//Add your code here } public static void CopyTo(this Stream input, Stream output) {//Add your code here } } }

C# code. Paste BELOW the Using statements

Copy Code

namespace MyClassLib
{  
    internal static class WebRequestHelper
    {   // Load raw data into MemoryStream from specified Url.
        public static Stream DownloadData(string url, int timeoutMilliseconds)        
        {//Add your code here  }       
        public static void DownloadDataAsync(string url, int timeoutMilliseconds, Action<MemoryStream> success, Action<Exception> error)
        {//Add your code here  }
        public static void CopyTo(this Stream input, Stream output)
        {//Add your code here  }
    }
}

Save and build your class library project and locate the new .dll file in its Bin>Debug folder. This file has the same name as your class library project, with a .dll extension.
Create a Basic End User Designer in a new solution following the steps in Creating a Basic End User Designer.
Run your Basic End User Designer project to create a EndUserDesigner.exe in your projects Bin>Debug folder.
Copy the Grapecity.ActiveReports.config file from the C:\Program Files\Common Files\GrapeCity\ActiveReports 10\ location and paste it into your End User Designer project's Bin>Debug folder.

Caution: Grapecity.ActiveReports.config file should always be placed inside the same folder as the EndUserDesigner.exe file for displaying a tile layer on a Map.
Right-click on the Grapecity.ActiveReports.config file and select Include in this Project to make changes in the config file.

Double-click to open the Grapecity.ActiveReports.config file and paste the following code between the <Configuration> and </Configuration> tags:

Paste between the <Configuration></Configuration> tags.	Copy Code
<!-- Register and configure custom tile provider. --> <MapTileProvider Name="Custom" DisplayName="Custom Provider" type="YourTileProvider, AssemblyName, Version = *x.x.x.x"> <Settings> <add key="ApiKey" value="API Key*" /> </Settings> </MapTileProvider>

Paste between the <Configuration></Configuration> tags.

Copy Code

<!-- Register and configure custom tile provider. -->
<MapTileProvider Name="Custom" DisplayName="Custom Provider" type="YourTileProvider, AssemblyName, Version = x.x.x.x">
    <Settings>
      <add key="ApiKey" value="API Key" />
    </Settings>
</MapTileProvider>

Note: Replace YourTileProvider with fully qualified class name and AssemblyName with the name of the assembly created after implementing IMapTileProvider and IMapTile interfaces.

Add the Class Library project created in step 5 to your Basic End User Designer project.
Copy the YourProjectName.dll created in step 5 and paste it to the current project's Bin>Debug folder together with the EndUserDesigner.exe.
Save and Run the project.
Create a Report containing a Map control in the Basic End User Designer. See Reports with Map for more information.
Add a Tile layer to the Map control. Right click the Tile layer and select Edit to view the custom tile provider added in the Provider drop-down. See Use a Tile Layer for more information.