export LD_LIBRARY_PATH=/opt/glfw-3.1.1/glfw-build/src:$LD_LIBRARY_PATH
export CPLUS_INCLUDE_PATH=/opt/glfw-3.1.1/include:$CPLUS_INCLUDE_PATH
export PKG_CONFIG_PATH=/opt/glfw-3.1.1/glfw-build/src:$PKG_CONFIG_PATH
#may symlinking of /usr/lib/libglfw3.a -> /opt/glfw-3.1.1/glfw-build/src/libglfw3.a is required
make linux
A couple of months ago the nice folks at RaspberryPi published a blog post about Tangram-ES, Mapzen's native 2D/3D map rendering engine running on their hardware. The feedback was great and people seemed to be very excited to start using it for their own projects.
Tangram-ES is a work-in-progress map engine written in C++ and openGL ES 2.0, so it can be a little intimidating to start from scratch. That's why we thought this small weekend project could get the ball rolling and ignite some ideas in the community.
In this github repository you will find:
A 3D-printable model to mount together a RaspberryPi A+/B+, Adafruit’s touch HDMI 5’’ 800x480 , Ultimate GPS Raspberry PI HAT, Lithium Ion Battery and PowerBoost 1000 Charger
Source code to run Tangram-es with a nice little graphical interface to move, rotate and zoom a map with a touch-only screen
Instructions for configuring Tangram-ES to load tiles locally using data for your own city or region
Besides your RaspberryPi I’m using the following components to make a stand alone device:
These are held together with the 3D-printed mounting station defined in the file: parts/rpi-screen-mount.stl.
Once you put everything together, it should look something like this:
Now let’s jump into the code of this project.
First we need to clone this repository in your raspberryPi and install some dependences to compile everything.
sudo apt-get update
sudo apt-get install cmake libcurl4-openssl-dev g++-4.8
cd ~
git clone https://github.com/tangrams/PI-GPS.git
cd PI-GPS
git submodule update --init --recursive
mkdir buildThen, just to make sure it is working, compile tangram and then run it.
export CXX=/usr/bin/g++-4.8
cd build
cmake ..
make
cd bin
./pi-gps -mNote: we are running tangram with the -m flag to display the mouse.
Getting fast internet access to your RaspberryPi could be a problem, especially if you are planning to use this GPS device on your bicycle. Let’s see what you need to do to download the map tiles locally making your map network-independent.
We installed Tangram-ES and tested it in the previous section. Now is time for us to make some changes so Tangram-ES will search for local files instead of fetching them from a server. Lucky us, we just need to change that from the configuration YAML file. As the web version of Tangram, this engine is super flexible and you can customize most of it from this file.
Go and open the ~/PI-GPS/tangram-es/core/resources/config.yaml file. And edit the following line:
sources:
osm:
type: MVT
url: http://vector.mapzen.com/osm/all/{z}/{x}/{y}.mvtSo it looks like:
sources:
osm:
type: GeoJSONTiles
url: file:///home/pi/PI-GPS/build/bin/tiles/{z}-{x}-{y}.jsonWith these changes, tangram will search for tiles inside the tiles/ directory.
My colleague and friend Peter Richardson made this useful set of python scripts for downloading tiles locally at the repo called Landgrab.
Let’s start by downloading some dependencies for this script.
sudo apt-get update
sudo apt-get install wget python-pip
sudo pip install requests
Then download Peter’s script in the directory where tangram was compiled:
cd ~/PI-GPS/build/bin
wget https://raw.githubusercontent.com/tangrams/landgrab/master/landgrab.pyNow is the time to download some vector tiles. For that we need the OpenStreetMap ID of the place we want to download. Go to OpenStreetMap Website and search for a location and check its ID (the number between brackets).
For example:
Note: To change the initial coordinates of the map, open ~/PI-GPS/tangram-es/core/resources/config.yaml again and add a line to the camera block so that it looks like this:
cameras:
camera1:
position: [-74.00976, 40.705327]
type: perspectiveSubstitute your own longitude and latitude in the position values. Once we choose a place, tangram will start fetching the vector tiles that we will need. For that we will use the python script we downloaded with the given OSM ID and the zoom level we are interested (in our case all of them are from 1 to 18).
python landgrab.py 3954665 1-18This may take a while. Go get a coffee.
Well done! Everything is ready, unplug your internet connection and run tangram on your RaspberryPi!
cd ~/PI-GPS/build/bin
./pi-gps -mI hope you are excited about all the possibilities of having cool 3D maps on your projects. Send us your opinions, feedback or photos of your work!