/vtm

vector-tile-map written in java with backends for android, desktop and gwt

Primary LanguageJavaGNU Lesser General Public License v3.0LGPL-3.0

<vector<tile>>map


http://www.opensciencemap.org
VTM is part of the OpenScienceMap project and developed at University of Bremen.

Features

  • Java map library
  • OpenGL vector-tile rendering
  • Themeable vector layers
  • Support for multiple tile sources:
    • primary opensciencemap (.vtm)
    • mapsforge files
    • experimental mapnik-vector-tile source
    • 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-android-app opensciencemap app using vtm-android
  • vtm-gdx common libgdx backend code
  • vtm-gdx-desktop Desktop application
  • vtm-gdx-html HTML5/GWT application
  • vtm-gdx-android Android application
  • vtm-gdx-ios iOS application

Getting started

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

Install Android SDK and build-tools 19.0.1. 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
export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools
echo yes | android update sdk --filter platform-tools --no-ui
echo yes | android update sdk --filter android-19 --no-ui
echo yes | android update sdk --filter extra-android-support --no-ui
echo yes | android update sdk --filter extra-android-m2repository --no-ui

Eclipse

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

Android-Studio

Just import build.gradle

Gradle

Or 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-gdx-desktop:run
to run the desktop demo (only Linux64 and Win64 native libs are provided atm)
./gradlew :vtm-gdx-html:jettyDraftWar
to run the webgl demo

WebGL Demo

OpenScienceMap

  • hold right mouse button to change view direction
  • Keys: g toggle tile-grid layer d default- t tubes- r osmarender-theme

Credits

This library contains code from several projects: