53 lines
1.9 KiB
Markdown
53 lines
1.9 KiB
Markdown
## A Vector Tile Map Library
|
|
|
|
VectorTileMap is part of the OpenScienceMap project, developed at University of Bremen.
|
|
http://www.opensciencemap.org
|
|
|
|
### Features
|
|
- Java map library
|
|
- OpenGL vector-tile rendering
|
|
- Themeable vector layers
|
|
- Support for multiple tile sources: primary opensciencemap (.vtm)
|
|
- vector: partially mapbox vector-tile and mapsforge files
|
|
- bitmap: any quadtree-scheme tiles as texture
|
|
- Backends for Android, Desktop and HTML5/WebGL (through libgdx and GWT)
|
|
|
|
### Getting started
|
|
```
|
|
git clone https://github.com/opensciencemap/vtm
|
|
cd vtm
|
|
git submodule init && git submodule update
|
|
ln -s ../../vtm/assets/styles vtm-android-app/assets/styles
|
|
ln -s ../../vtm/assets/patterns vtm-android-app/assets/patterns
|
|
```
|
|
|
|
Then import projects into eclipse. Dont forget 'git submodule update' after git pull/checkout!
|
|
|
|
To set up a tile server for .vtm tiles see https://github.com/opensciencemap/TileStache/tree/master/TileStache/OSciMap4
|
|
|
|
### 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-gdx-desktop** Desktop application
|
|
- **vtm-gdx-html** HTML5/GWT application
|
|
- **vtm-gdx-android** Android application using libgdx backend
|
|
|
|
### WebGL Demo
|
|
http://opensciencemap.org/map/#scale=17,rot=61,tilt=51,lat=53.075,lon=8.807
|
|
- hold middle mouse button to change view direction
|
|
- Keys
|
|
- g - toggle tile-grid layer
|
|
- d - default theme
|
|
- t - tubes theme
|
|
|
|
|
|
### 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)
|