{"id":13548330,"url":"https://github.com/karimnaaji/vectiler","last_synced_at":"2025-04-04T21:11:30.598Z","repository":{"id":3290843,"uuid":"45361762","full_name":"karimnaaji/vectiler","owner":"karimnaaji","description":"A vector tile, terrain and city 3d model builder and CLI exporter. Consider using its fully integrated user interface at https://halfmaps.io","archived":false,"fork":false,"pushed_at":"2024-05-20T15:31:54.000Z","size":24081,"stargazers_count":495,"open_issues_count":4,"forks_count":72,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-03-28T20:11:16.688Z","etag":null,"topics":["city-builder","computer-graphics","cpp","models","openstreetmap","osm","srtm","terrain","vector-tiles"],"latest_commit_sha":null,"homepage":"https://karim.naaji.fr/projects/vectiler","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/karimnaaji.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-11-01T23:21:15.000Z","updated_at":"2025-03-24T06:16:26.000Z","dependencies_parsed_at":"2024-08-01T12:15:42.335Z","dependency_job_id":"7ae9a45e-7fa6-47e2-b846-d63d679ee5a9","html_url":"https://github.com/karimnaaji/vectiler","commit_stats":{"total_commits":99,"total_committers":3,"mean_commits":33.0,"dds":0.02020202020202022,"last_synced_commit":"76e71c852b020fb5b877c0b03dfeb263a632df71"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karimnaaji%2Fvectiler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karimnaaji%2Fvectiler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karimnaaji%2Fvectiler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karimnaaji%2Fvectiler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/karimnaaji","download_url":"https://codeload.github.com/karimnaaji/vectiler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247249534,"owners_count":20908212,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["city-builder","computer-graphics","cpp","models","openstreetmap","osm","srtm","terrain","vector-tiles"],"created_at":"2024-08-01T12:01:08.903Z","updated_at":"2025-04-04T21:11:30.536Z","avatar_url":"https://github.com/karimnaaji.png","language":"C++","funding_links":[],"categories":["C++","cpp","\u003ca name=\"cpp\"\u003e\u003c/a\u003eC++"],"sub_categories":[],"readme":"# vectiler\r\n\r\n|Platform|Build Status|\r\n|--------|------|\r\n|OS X/Linux|[![Build Status](https://travis-ci.org/karimnaaji/vectiler.svg?branch=master)](https://travis-ci.org/karimnaaji/vectiler)|\r\n|Windows|[![Build status](https://ci.appveyor.com/api/projects/status/985uxs6rk8044ols/branch/master?svg=true)](https://ci.appveyor.com/project/karimnaaji/vectiler/branch/master)|\r\n\r\nA wavefront obj vector tile builder and exporter based on [mapzen](https://mapzen.com) [vector tiles](https://mapzen.com/projects/vector-tiles).\r\n\r\n- build and export mesh in obj files based on tile coordinates (find your tiles of interest [here](http://www.maptiler.org/google-maps-coordinates-tile-bounds-projection/))\r\n\r\n![](img/vectiler.png)\r\n\r\n**export example**\r\n\r\n- [sketchfab.com/e7ee1c](https://sketchfab.com/models/e7ee1c0047ce4b5dbc768adcf7a7264e)\r\n- [sketchfab.com/693df3](https://sketchfab.com/models/693df3f9180942fba3f865e0d5ddc0ce)\r\n\r\n**fetch submodules**\r\n\r\nFirst initialize submodules by running:\r\n```sh\r\n$ git submodule update --init --recursive\r\n```\r\n\r\n**install dependencies (OS X)**\r\n\r\n```sh\r\n$ brew install cmake\r\n```\r\n\r\n**install dependencies (Linux)**\r\n\r\nTo build vectiler you will need a compiler that supports `c++11`, for example with `g++-4.9` on an ubuntu machine:\r\n\r\n```\r\n$ sudo add-apt-repository ppa:ubuntu-toolchain-r/test\r\n$ sudo apt-get update\r\n$ sudo apt-get install g++-4.9 cmake libcurl4-openssl-dev\r\n```\r\n\r\n**build (OS X/Linux)**\r\n\r\nTo build with cmake in a `build/` directory run the following:\r\n```shell\r\ncmake . -Bbuild\r\ncmake --build build\r\n```\r\n\r\n**build (Windows)**\r\n\r\nFirst install CMake for Windows and then run the following commands in a command line tool like MinGW:\r\n```sh\r\n$ mkdir build\r\n$ cd build\r\n$ cmake .. -G \"Visual Studio 14 2015 Win64\"\r\n$ cmake --build .\r\n```\r\n\r\n**usage**\r\n\r\n```\r\n  Usage: ./vectiler.out [options]\r\n\r\n  Options:\r\n    --name                     File name ((null))\r\n    --apikey                   Nextzen Developer API key (https://developers.nextzen.org/)\r\n    --splitMeshes              Generate one mesh per feature in wavefront file (0)\r\n    --tilex                    Tile X (can be a tile range: 19294/19295) (19294)\r\n    --tiley                    Tile Y (can be a tile range: 24642/24643) (24642)\r\n    --tilez                    Tile Z (zoom) (16)\r\n    --offsetx                  Global tile Offset on X coordinate (0.0)\r\n    --offsety                  Global tile Offset on Y coordinate (0.0)\r\n    --append                   Append the obj to an existing obj file (0)\r\n    --buildings                Whether to export building geometry (1)\r\n    --buildingsExtrusionScale  Building height scale factor (1.0)\r\n    --buildingsHeight          The height at which building should be extruded (if no height data is available) (0.0)\r\n    --pedestal                 Build a pedestal when running with terrain option (Useful for 3d printing) (0)\r\n    --pedestalHeight           Pedestal height, can be negative (0.0)\r\n    --terrain                  Generate terrain elevation topography (0)\r\n    --terrainSubdivision       Terrain mesh subdivision (64)\r\n    --terrainExtrusionScale    Terrain mesh extrusion scale (1.0)\r\n    --roads                    Whether to export roads geometry (0)\r\n    --roadsHeight              The roads height offset (z-axis) (1.0)\r\n    --roadsExtrusionWidth      The roads extrusion width (5.0)\r\n    --normals                  Export with normals (0)\r\n    --version                  Output version\r\n    --help                     Output help\r\n```\r\n\r\n**terrain**\r\n\r\nTerrain export is only available over zoom 15 (`--tilez`):\r\n\r\n```sh\r\n$ ./vectiler --tilex 5242/5260 --tiley 12642/12666 --tilez 15 --terrain 1 --buildings 1 --terrainExtrusionScale 1.5 --buildingsExtrusionScale 1.9\r\n```\r\n![](img/terrain2.png)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarimnaaji%2Fvectiler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkarimnaaji%2Fvectiler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarimnaaji%2Fvectiler/lists"}