tileblaster v1.0.13

tileblaster

tileblaster is a map tile caching (and optimizing) proxy, designed to run with nginx.

install

npm i tileblaster -g

use --no-optional if you don't want tile optimization or versatiles support.

run

tileblaster /path/to/config.js

Use pm2, nodemon, forever or similar to run tileblaster as service;

configuration

see config.js.dist

nginx configuration

upstream upstream_tileblaster {
	server unix:/path/to/tileblaster.sock;
}

server {
	listen 80;
	server_name tileblaster;

	gzip_static on;
	# brotli_static on; # if ngx_brotli is available

	if (-f $document_root/$uri.err) {
		return 204;
	}

	location / {
		root /path/to/tileblaster/tiles;
		try_files $uri $uri/ @tileblaster;
	}

	location @tileblaster {
		proxy_pass http://upstream_tileblaster;
	}
}

usage

get the tiles via http://server/<mapid>/<z>/<x>/<y>[<d>].<ext>

• <mapid> is the map id specified in your config.js
• <z>, <x> and <z> are the tile coorinates
• <d> is the optional pixel density marker, for example @2x
• <ext> is the extension, for example png, geojson or pbf