vectiler
Platform | Build Status |
---|---|
OS X/Linux | |
Windows |
A wavefront obj vector tile builder and exporter based on mapzen vector tiles.
- build and export mesh in obj files based on tile coordinates (find your tiles of interest here)
export example
fetch submodules
First initialize submodules by running:
$ git submodule update --init --recursive
install dependencies (OS X)
$ brew install cmake
install dependencies (Linux)
To build vectiler you will need a compiler that supports c++11
, for example with g++-4.9
on an ubuntu machine:
$ sudo add-apt-repository ppa:ubuntu-toolchain-r/test
$ sudo apt-get update
$ sudo apt-get install g++-4.9 cmake libcurl4-openssl-dev
build (OS X/Linux)
To build with cmake in a build/
directory run the following:
$ cmake . -Bbuild
$ cmake --build build
build (Windows)
First install CMake for Windows and then run the following commands in a command line tool like MinGW:
$ mkdir build
$ cd build
$ cmake .. -G "Visual Studio 14 2015 Win64"
$ cmake --build .
usage
Usage: ./vectiler.out [options]
Options:
--name  File name ((null))
--apikey  Developer API key (https://mapzen.com/developers/) (vector-tiles-qVaBcRA)
--splitMeshes  Generate one mesh per feature in wavefront file (0)
--tilex  Tile X (can be a tile range: 19294/19295) (19294)
--tiley  Tile Y (can be a tile range: 24642/24643) (24642)
--tilez  Tile Z (zoom) (16)
--offsetx  Global tile Offset on X coordinate (0.0)
--offsety  Global tile Offset on Y coordinate (0.0)
--append  Append the obj to an existing obj file (0)
--buildings  Whether to export building geometry (1)
--buildingsExtrusionScale  Building height scale factor (1.0)
--buildingsHeight  The height at which building should be extruded (if no height data is available) (0.0)
--pedestal  Build a pedestal when running with terrain option (Useful for 3d printing) (0)
--pedestalHeight  Pedestal height, can be negative (0.0)
--terrain  Generate terrain elevation topography (0)
--terrainSubdivision  Terrain mesh subdivision (64)
--terrainExtrusionScale  Terrain mesh extrusion scale (1.0)
--roads  Whether to export roads geometry (0)
--roadsHeight  The roads height offset (z-axis) (1.0)
--roadsExtrusionWidth  The roads extrusion width (5.0)
--normals  Export with normals (0)
--version  Output version
--help  Output help
terrain
Terrain export is only available over zoom 15 (--tilez
):
$ ./vectiler --tilex 5242/5260 --tiley 12642/12666 --tilez 15 --terrain 1 --buildings 1 --terrainExtrusionScale 1.5 --buildingsExtrusionScale 1.9