mapsforge/vtm

OpenGL vector map library - running on Android, iOS, Desktop and browser.

Download

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}
	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.mapsforge:vtm:0.21.0'
	}
	<dependency>
	    <groupId>com.github.mapsforge</groupId>
	    <artifactId>vtm</artifactId>
	    <version>0.21.0</version>
	</dependency>

                            
    libraryDependencies += "com.github.mapsforge" % "vtm" % "0.21.0"
        
        

                            
    :dependencies [[com.github.mapsforge/vtm "0.21.0"]]

Readme

Maven Central License: LGPL v3

V™

<img src="docs/logo/VTM.svg" style="bottom:0;" width="200" align="right">

VTM (Vector Tile Map) was developed within the OpenScienceMap project.

This fork continues VTM development and provides compatibility with Mapsforge.

See the integration guide and changelog. And read through how to contribute guidelines.

If you have any questions or problems, don't hesitate to ask the Discussions for help.

Features

  • Java map library
  • OpenGL vector-tile rendering
  • Themeable vector layers (render themes)
  • Support for multiple tile sources:
    • OpenScienceMap vector tiles
    • Mapsforge vector maps
    • MBTiles vector & raster maps
    • Mapbox vector tiles (e.g. Mapilion, Mapzen, Nextzen, OpenMapTiles)
    • GeoJSON vector tiles (e.g. Mapzen, Nextzen)
    • Raster tiles: any quadtree-scheme tiles as texture
  • Backends:
  • Building VTM: set ANDROID_HOME environment variable with the Android SDK installation directory

Projects

  • vtm core library
  • vtm-android Android backend
  • vtm-android-example Android examples
  • vtm-gdx common libGDX backend
  • vtm-android-gdx Android libGDX backend
  • vtm-desktop Desktop libGDX backend
  • vtm-desktop-lwjgl Desktop LWJGL backend
  • vtm-desktop-lwjgl3 Desktop LWJGL 3 backend
  • vtm-playground Desktop examples
  • vtm-ios iOS libGDX backend
  • vtm-ios-example iOS examples
  • vtm-web HTML5/GWT libGDX backend
  • vtm-web-app HTML5/GWT application

WebGL Demo

OpenScienceMap view of Bremen. Running nextzen2oscimv4 server which contains OSM data in Germany. Notice: nextzen2oscimv4 server is still unstable.

Applications

Maps

Credits

This library contains code from several projects:

  • Android (Apache 2.0): some Matrix code, TimSort (http://source.android.com)
  • libGDX (Apache 2.0): AsyncTask, MathUtils, Interpolation, PixmapPacker (https://github.com/libgdx)
  • mapsforge (LGPL3): based on 0.2.4 (https://github.com/mapsforge/mapsforge)
  • osmdroid (Apache 2.0): some overlay classes (https://github.com/osmdroid/osmdroid)
  • tessellate (SGI Free Software License B 2.0): (https://github.com/cscheid/tessellate)

License

VTM library is under LGPL v3 license, with an important simplification: the constraints mentioned in sections LGPL v3 §4(d) and §4(e) are waived.

This means that you are allowed to convey a Combined Work without providing the user any way to recombine or relink the application and without providing any shared library mechanism.

In other words, you are allowed to include VTM library in your Android application, without making your application open source.

Screenshots

| Android | iOS | | ------------- | ------------- | |<img src="docs/images/android.png" width="1000">|<img src="docs/images/ios.png" width="1000">|

| Desktop | | ------------- | |Desktop|

| Browser | | ------------- | |Browser|