XAML-Map-Control/MapsforgeTiles
2026-02-24 10:19:28 +01:00
..
Avalonia Updated MapsforgeTiles 2026-02-24 10:19:28 +01:00
Shared Updated MapsforgeTiles 2026-02-24 10:19:28 +01:00
UWP Updated MapsforgeTiles projects 2026-02-15 00:09:21 +01:00
WinUI Updated MapsforgeTiles 2026-02-24 10:19:28 +01:00
WPF Updated MapsforgeTiles 2026-02-24 10:19:28 +01:00
pom.xml Updated MapsforgeTiles projects 2026-02-15 00:09:21 +01:00
README.md Updated MapsforgeTiles 2026-02-24 10:19:28 +01:00

MapsforgeTiles

Tile source libraries for loading map content from vector map files.

The MapsforgeTileSource class in these libraries uses parts of the Mapsforge Java library, which is made accessible to .NET via IKVM, a Java Virtual Machine for .NET. Mapsforge is published under a simplified variant of the LGPL v3 license.

Map files can be downloaded from the Mapsforge Download Server.

MapsforgeTileSource is initialized by a static LoadMaps method that takes the file path to either a single map file or a directory containing multiple map files.

The MapsforgeTileSource instance constructor takes a string parameter that specifies a Mapsforge theme. This is either the full path of an XML rendertheme file, or the name of one of the built-in themes (ignoring case), e.g. Default. See MapsforgeThemes.java for available theme names. An additional constructor parameters specifies the size of the tile source's internal cache.

Code sample:

MapControl.MapsforgeTiles.MapsforgeTileSource.Initialize(".\mapfiles");

map.MapLayer = new MapTileLayer
{
    TileSource = new MapControl.MapsforgeTiles.MapsforgeTileSource("Default")
};

While building with IKVM's MavenReference succeeds, running a RenderThemeFuture always fails with a NoClassDefFoundError exception for org.xmlpull.v1.XmlPullParserFactory.

An alternative approach is to import Mapsforge classes by an IkvmReference that references a local JAR file with all required dependencies. This JAR is built from pom.xml in the MapsforgeTiles directory, by a custom PreBuild event in the project files which executes the command

mvn package

So in order to build the MapsforgeTiles libraries, a Maven installation is required.