This project uses CMake (minimum version 3.0), you can download it here or install it with apt-get.
sudo apt-get install cmake
Make sure to update git submodules before you build:
git submodule update --init
To build on Rasberry Pi you will need a C++ toolchain with support for C++14. GCC 4.9.2 (or higher) and Clang 3.4 (or higher) are known to work (refer here for instructions on getting GCC 4.9).
You will also need to install development packages for libcurl:
sudo apt-get install libcurl4-openssl-dev
The demo application uses the Mapzen vector tile service, so you will need a Mapzen API key to build and run the demo.
-
Visit https://mapzen.com/documentation/overview/#get-started-developing-with-mapzen to get an API key.
-
Setup an environment variable (
MAPZEN_API_KEY
) to point to your API key.export MAPZEN_API_KEY=YOUR_API_KEY
Compile the demo application with:
make rpi
You can optionally use make -j
to parallelize the build and append DEBUG=1
or RELEASE=1
to choose the build type.
Run the demo program from the output folder:
cd build/rpi/bin
./tangram
You can provide several command line options:
-s
or--scene
followed by a path or URL to a scene file to load-lat
or--latitude
followed by a latitude for the map view-lon
or--longitude
followed by a longitude for the map view-z
or--zoom
followed by a zoom level for the map view-x
or--x_position
followed by a horizontal offset in pixels for the window-y
or--y_position
followed by a vertical offset in pixels for the window-w
or--width
followed by a horizontal size in pixels for the window-h
or--height
followed by a vertical size in pixels for the window-t
or--tilt
followed by a tilt in radians for the map view-r
or--rotation
followed by a rotation from North in radians for the map view
You can move the map with w
, a
, s
, and d
, zoom in and out with -
and =
, and quit with esc
.