Progress® Telerik® Reporting R3 2021

GenericTileProvider Class

A class used to obtain map tiles from any tile server compliant with Web Map Tile Service protocol.

Inheritance Hierarchy

SystemObject
  Telerik.ReportingTileProvider
    Telerik.ReportingGenericTileProvider

Namespace:  Telerik.Reporting
Assembly:  Telerik.Reporting (in Telerik.Reporting.dll)

Syntax

C#

VB

Copy

public class GenericTileProvider : TileProvider

Public Class GenericTileProvider
	Inherits TileProvider

The GenericTileProvider type exposes the following members.

Constructors

	Name	Description
	GenericTileProvider	Initializes a new instance of the GenericTileProvider class

Top

Properties

	Name	Description
	Attribution	Gets or sets the Attribution property must be set manually according to the tile provider usage policy. This text will be displayed in the lower right corner of the map area.
	LogoUrl	Gets or sets the LogoUrl property denotes the URL used to download the tile provider logo, if required by the provider's usage policy. In case the URL points to a valid image, it will be displayed in the lower left corner of the map area.
	TileImageFormat	Obsolete. Gets or sets the TileImageFormat that will be used when returning the requested tile image to the client. (Inherited from TileProvider.)
	UrlSubdomains	Gets a collection of subdomains that will replace the {subdomain} tag in the UrlTemplate. When more than one subdomain is specified, the tile requests will be distributed evenly among the subdomains.
	UrlTemplate	Gets or sets a templated URL that will be used to fetch the tiles from the tile provider. Valid template patterns are {subdomain}, {x}, {y}, {zoom}.
	UserAgent	Gets or sets the UserAgent header value that will be used when sending requests to the tile provider servers.

Top

Remarks

By default, the GenericTileProvider is initialized using the MapQuest tile server properties.

Examples

The following example demonstrates how to initialize a GenericTileProvider instance:

C#

VB

Copy

public void HowToInitializeGenericTileProvider()
{
    //Creating the GenericTileProvider instance
    Telerik.Reporting.GenericTileProvider genericTileProvider1 = new Telerik.Reporting.GenericTileProvider();

    //Setting the attribution text that will be shown at the bottom right corner of the map control.
    genericTileProvider1.Attribution = "Tiles courtesy of MapQuest";

    //Setting the URL to the image file that will be used to download the tile provider logo, if required by the provider's usage policy
    genericTileProvider1.LogoUrl = "http://developer.mapquest.com/content/osm/mq_logo.png";

    //Specifying the URL template that will be used to get the tiles from the tile server.
    genericTileProvider1.UrlTemplate = "http://{subdomain}.mqcdn.com/tiles/1.0.0/map/{zoom}/{x}/{y}.jpg";

    //Adding the subdomains used to distribute the tile requests evenly. They will replace the {subdomain} tag in the UrlTemplate.
    genericTileProvider1.UrlSubdomains.Add("otile1");
    genericTileProvider1.UrlSubdomains.Add("otile2");
    genericTileProvider1.UrlSubdomains.Add("otile3");
    genericTileProvider1.UrlSubdomains.Add("otile4");

    //Assigning the tile provider to the map instance
    this.map.TileProvider = genericTileProvider1;
}

Public Sub HowToInitializeGenericTileProvider()
    'Creating the GenericTileProvider instance
    Dim genericTileProvider1 As New Telerik.Reporting.GenericTileProvider()

    'Setting the attribution text that will be shown at the bottom right corner of the map control.
    genericTileProvider1.Attribution = "Tiles courtesy of MapQuest"

    'Setting the URL to the image file that will be used to download the tile provider logo, if required by the provider's usage policy
    genericTileProvider1.LogoUrl = "http://developer.mapquest.com/content/osm/mq_logo.png"

    'Specifying the URL template that will be used to get the tiles from the tile server.
    genericTileProvider1.UrlTemplate = "http://{subdomain}.mqcdn.com/tiles/1.0.0/map/{zoom}/{x}/{y}.jpg"

    'Adding the subdomains used to distribute the tile requests evenly. They will replace the {subdomain} tag in the UrlTemplate.
    genericTileProvider1.UrlSubdomains.Add("otile1")
    genericTileProvider1.UrlSubdomains.Add("otile2")
    genericTileProvider1.UrlSubdomains.Add("otile3")
    genericTileProvider1.UrlSubdomains.Add("otile4")

    'Assigning the tile provider to the map instance
    Me.map.TileProvider = genericTileProvider1
End Sub

Version Information

Supported in: 1.0.1

See Also

Reference

Telerik.Reporting Namespace