hjanetzek/vtm

Vector-tile-map library and stuff with backends for Android, Desktop, GWT and iOS

V™

VTM is developed within the OpenScienceMap project.

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.

Getting started

git clone --recursive https://github.com/opensciencemap/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)