vectiler

A vector tile, terrain and city 3d model builder and exporter

Github stars Tracking Chart

vectiler, Platform, Build Status, --------, ------, OS X/Linux, Build Status, Windows, Build status, 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

Overview

Name With Ownerkarimnaaji/vectiler
Primary LanguageC++
Program languageCMake (Language Count: 3)
Platform
License:MIT License
Release Count1
Last Release Name0.1.0 (Posted on )
First Release Name0.1.0 (Posted on )
Created At2015-11-01 23:21:15
Pushed At2021-12-23 05:20:37
Last Commit At2021-06-29 14:20:30
Stargazers Count474
Watchers Count27
Fork Count70
Commits Count110
Has Issues Enabled
Issues Count15
Issue Open Count3
Pull Requests Count12
Pull Requests Open Count1
Pull Requests Close Count1
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private
To the top