V™

VTM was developed within the OpenScienceMap project.

This fork is for continue VTM development and make it compatible with latest Mapsforge.

If you have any questions or problems, don't hesitate to ask our public mailing list for help. You can also report bugs and improvement requests via our issue tracker. And read through how to contribute guidelines.

Features

• Java map library
• OpenGL vector-tile rendering
• Themeable vector layers
• Support for multiple tile sources:
  • primary opensciencemap (.vtm)
  • mapsforge files
  • GeoJSON tiles
  • bitmap: any quadtree-scheme tiles as texture
• Backends:
  • Android
  • Desktop (using libgdx/LwjGL)
  • HTML5/WebGL (using libgdx/GWT)
  • iOS (using libgdx/robovm)

Projects

• vtm contains the core library
• vtm-android Android backend (no libgdx required)
• vtm-android-example provides examples using vtm-android
• vtm-gdx common libgdx backend code
• vtm-android-gdx Android application
• vtm-desktop Desktop application
• vtm-web HTML5/GWT backend
• vtm-web-app HTML5/GWT application
• vtm-ios iOS application

The libgdx backends for GWT and iOS are very experimental.

Master build downloads

• Latest jars and Samples applications

Getting started

git clone --recursive https://github.com/mapsforge/vtm

Install Android SDK and build-tools 20.0. From extras add 'Android Support Library/Repository' and 'Google Repository'. The commands below should set things up correctly when Android SDK is already installed.

export ANDROID_HOME=/path/to/your/android-sdk
./android-stuff.sh

Eclipse

./gradlew eclipse
Import all 'vtm' sub-projects into Eclipse.

Android-Studio

Just import build.gradle

Gradle

You can run gradle tasks directly (see also ./gradlew -q tasks):
./gradlew clean install
to build the libraries and add them to the local maven repository.
./gradlew :vtm-android-example:run
to run the android example
./gradlew :vtm-desktop:run
to run the desktop demo (only Linux64 and Win64 native libs are provided atm)
./gradlew :vtm-web-app:jettyDraftWar
to run the webgl demo

WebGL Demo

OpenScienceMap view of Bremen.

• hold right mouse button to change view direction

Credits

This library contains code from several projects:

• mapsforge: based on 0.2.4 (http://mapsforge.org)
• osmdroid: some overlay classes (http://code.google.com/p/osmdroid/)
• libgdx: AsyncTask, MathUtils and Interpolation classes (https://github.com/libgdx)
• Android: some Matrix code, TimSort (http://source.android.com)
• tessellate: (https://github.com/cscheid/tessellate)