# LocalMapProvider

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

> caption Figure 1: LocalMapProvider

![WinForms RadMap LocalMapProvider](https://www.telerik.com/products/winforms/documentation/assets/ef874f643c0c6be2e79451ef0bab31d8/map-localmapprovider001.png)

#### 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);
        
```

```VB.NET
Dim mapFolder As String = "..\..\World"
Dim provider As New LocalMapProvider()
provider.DirectoryPath = mapFolder
provider.FileFormat = "os_{0}_{1}_{2}.png"
provider.MinZoomLevel = 1
provider.MaxZoomLevel = 9
radMap1.Providers.Add(provider)

```

> note 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

| Property             | Description                                                                                           |
| -------------------- | ----------------------------------------------------------------------------------------------------- |
| **DirectoryPath**    | Specifies the folder path.                                                                            |
| **FileFormat**       | Specifies the file format.                                                                            |
| **NoImageAvailable** | Gets or sets an image that will be displayed when a tile image cannot be retrieved or does not exist. |
| **TileSize**         | Gets the tile size.                                                                                   |
| **Initialized**      | Gets or sets a value indicating whether this LocalMapProvider is initialized.                         |

## Methods

| Method       | Description                        |
| ------------ | ---------------------------------- |
| **LoadTile** | Loads the tile image by x,y, zoom. |