MbTilesDataProvider Class
A data provider that loads vector tiles from a MbTiles database.
Namespace: DevExpress.XtraMap
Assembly: DevExpress.XtraMap.v24.2.dll
Declaration
Remarks
A set of tiles can be packaged in MbTiles files (wrapped SQLite databases) stored locally or on a server. MbTiles can also contain raster tiles.
Follow the steps below to load data from a MbTiles file:
- Install the System.Data.SQLite.Core package if your application does not reference this library.
- Create an image layer and add it to the MapControl.Layers collection.
- Create an
MbTilesDataProvider
instance and assign it to the ImageLayer.DataProvider property. - Use the MbTilesDataProvider.FileUri property to specify a path to an MbTiles file.
private void Form1_Load(object sender, EventArgs e) {
ImageLayer layer = new ImageLayer();
MbTilesDataProvider dataProvider = new MbTilesDataProvider();
dataProvider.FileUri = new Uri(@"D:\countries.mbtiles", UriKind.Absolute);
layer.DataProvider = dataProvider;
mapControl1.Layers.Add(layer);
}
Apply a Custom Style
If a default vector tile style does not meet your requirements, you can apply a custom style. Use the VectorTileDataProviderBase.StyleFileUri property to define a path to a style file. The MapControl uses System.Text.Json library to parse style files. Install the System.Text.Json package if your .NET Framework application does not reference this library. .NET projects do not require manual installation of the System.Text.Json package, as it is already included in the .NET environment. Set the DevExpress.Map.Native.VectorTileStyleParser.ProcessingLibrary
property to NewtonsoftJson
to use the Newtonsoft.Json library instead. See Vector Tile Providers: Vector Tile Styles for more information about styles.
The following code loads a style file from the project’s Data directory:
dataProvider.StyleFileUri = new Uri(GetRelativePath("style.json"), UriKind.Absolute);
public static string GetRelativePath(string name) {
name = "Data\\" + name;
DirectoryInfo dir = new DirectoryInfo(Application.StartupPath);
while (dir != null) {
string filePath = Path.Combine(dir.FullName, name);
if (File.Exists(filePath))
return filePath;
dir = Directory.GetParent(dir.FullName);
}
return string.Empty;
}