naru

Vector Tile Academy (VTA) code for Raspberry Pi

Background

This repository is the Raspberry Pi implementation for Vector Tile Academy.

Use

Log in to your Raspbian and then execute the following.

Install and download (requires internet connection)

curl -sL https://unvt.github.io/equinox/install.sh | bash -
git clone https://github.com/unvt/naru.git
cd naru
rake inet:install # install extra software
vi .env #specify OSM regison and area for tiles
rake inet:download # donwload source geospatial data for exercise
rake inet:sprite # download and generate sprite files

First time exercise

rake inet:download # download osm.pbf
rake inet:mbgljs # download mapbox-gl-js package
rake js # rollup javascript code
rake inet:sprite # download maki and build sprite
rake inet:fonts # download fonts and create glyphs
rake tiles # create mbtiles under src folder
rake style # create style.json
rake host # host unvt on budo

Advanced exercise

rake inet:mbgljs
rake js
rake inet:fonts
rake inet:sprite
rake optimizer # analyze tiles.mbtiles
rake shaver

Shutdown Raspberry Pi

sudo poweroff

Now it is OK to disconnect Raspberry Pi.

Implementation details

List of software installed by rake inet:install

Node.js

• @mapbox/vtshaver
• vt-optimizer

Ruby

• mdless
• dotenv

policy

the list shall be minimized, moving items to equinox.

Run on Docker

• for creating tiles.mbtiles from the latest osm.pbf

docker build . --tag unvt/naru
docker run -v ${pwd}:/usr/src/app -p 9966:9966 -it unvt/naru

cd /usr/src/app
vi .env #specify OSM regison and area for tiles
rake inet:download # download osm.pbf
rake inet:mbgljs # download mapbox-gl-js package
rake js # rollup javascript code
rake inet:sprite # download maki and build sprite
rake inet:fonts # download fonts and create glyphs
rake tiles # create mbtiles under src folder
rake style # create style.json
rake optimizer # analyze tiles.mbtiles

note: npm packages, "are-we-there-yet", "mapnik", and "fontnik" were requested at my trial (TU in May 2021)

• for hosting tiles after creating by UNVT

docker build . --tag unvt/naru
cp .env.example .env
vi .env # specify your target REGION and AREA on .env file
docker-compose up

About the name

naru means "to be implemented" in traditional Japanese. It was taken from "いづ方をも捨てじと心にとり持ちては、一事もなるべからず" of 徒然草 一八八, which roughly means "If you try to take care of everything, nothing can be implemented."