New to Telerik UI for WinFormsStart a free 30-day trial

LocalMapProvider

Updated on Aug 13, 2025

RadMap can visualize data from local image files by using a LocalMapProvider.

Figure 1: LocalMapProvider

WinForms RadMap LocalMapProvider

Using LocalMapProvider

C#
            
string mapFolder = @"..\..\World";
LocalMapProvider provider = new LocalMapProvider();
provider.DirectoryPath = mapFolder;
provider.FileFormat = "os_{0}_{1}_{2}.png";
provider.MinZoomLevel = 1;
provider.MaxZoomLevel = 9;
radMap1.Providers.Add(provider);

The FileFormat property specifies what is the exact format of the image files stored in the local folder. The parameters needed are the tile X {0} and Y {1} numbers and the Zoom level {2}. In the code snippet above, each file image's name is built by using x,y,z values: "os_X_Y_Z.png".

Properties

PropertyDescription
DirectoryPathSpecifies the folder path.
FileFormatSpecifies the file format.
NoImageAvailableGets or sets an image that will be displayed when a tile image cannot be retrieved or does not exist.
TileSizeGets the tile size.
InitializedGets or sets a value indicating whether this LocalMapProvider is initialized.

Methods

MethodDescription
LoadTileLoads the tile image by x,y, zoom.
In this article
PropertiesMethods
Not finding the help you need?
Contact Support