https://github.com/mapsforge/vtm
OpenGL vector map library - running on Android, iOS, Desktop and browser.
https://github.com/mapsforge/vtm
java map opengl openstreetmap vector
Last synced: 4 months ago
JSON representation
OpenGL vector map library - running on Android, iOS, Desktop and browser.
- Host: GitHub
- URL: https://github.com/mapsforge/vtm
- Owner: mapsforge
- License: lgpl-3.0
- Fork: true (opensciencemap/vtm)
- Created: 2016-06-15T12:55:48.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-09-15T11:27:12.000Z (4 months ago)
- Last Synced: 2025-09-15T13:19:55.172Z (4 months ago)
- Topics: java, map, opengl, openstreetmap, vector
- Language: Java
- Homepage:
- Size: 34 MB
- Stars: 288
- Watchers: 33
- Forks: 95
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: COPYING
Awesome Lists containing this project
README
[](https://jitpack.io/#mapsforge/vtm)
[](http://www.gnu.org/licenses/lgpl-3.0)
# V™
VTM (Vector Tile Map) was developed within the [OpenScienceMap](https://github.com/opensciencemap) project.
**This fork continues VTM development and provides compatibility with [Mapsforge](https://github.com/mapsforge/mapsforge).**
See the **[integration guide](docs/Integration.md)** and [changelog](docs/Changelog.md). And read through [how to contribute](docs/CONTRIBUTING.md) guidelines.
If you have any questions or problems, don't hesitate to ask the [forum](https://github.com/mapsforge/vtm/discussions) for help.
## Features
- Java map library
- OpenGL vector-tile rendering
- Themeable vector layers ([render themes](docs/Rendertheme.md))
- Hillshading from HGT digital elevation model data
- Support for multiple tile sources:
- Mapsforge vector maps
- MBTiles vector & raster
- Mapbox vector tiles
- GeoJSON vector tiles
- OpenScienceMap vector tiles
- Raster tiles
- Backends:
- Android ([example](vtm-android-example))
- iOS (libGDX/RoboVM, [instructions](docs/ios.md))
- Desktop (libGDX/LWJGL, [instructions](docs/desktop.md))
- HTML5/WebGL (libGDX/GWT, [instructions](docs/web.md))
- Building VTM: set `ANDROID_HOME` environment variable with the Android SDK installation directory
### Projects
- **vtm** core library
- **vtm-hillshading** hillshading
- **vtm-jts** overlays
- **vtm-http** online tiles
- **vtm-mvt** MBTiles
- **vtm-android** Android backend
- **vtm-android-example** Android examples
- **vtm-gdx** common libGDX backend
- **vtm-desktop** Desktop libGDX 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](https://oscim.ogiqvo.com/vtm/#scale=17,rot=61,tilt=51,lat=53.075,lon=8.807) view of Bremen. Running [nextzen2oscimv4](https://github.com/schedul-xor/nextzen2oscimv4) server which contains OSM data in Germany. Notice: nextzen2oscimv4 server is still unstable.
## Applications
- VTM is used by many [applications](docs/Applications.md).
## Maps
- Mapsforge [map providers](docs/Mapsforge-Maps.md).
## 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](http://www.gnu.org/licenses/lgpl-3.0), 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 |
| ------------- |
||
||
| Android | iOS |
| ------------- | ------------- |
|
|
|
| Desktop |
| ------------- |
||
| Browser |
| ------------- |
||