crofty/tl

An alternate command line interface to tilelive

tl

A command line alternative to tilelive that supports streaming copies and static image rendering.

Installation

npm install -g tl
npm install -g mbtiles tilelive-file
# install any other tilelive modules you'd like to read/write from

Usage

Copy tiles from a filesystem to an MBTiles archive (assumes that tilelive-file and mbtiles are installed):

tl copy file://./tiles mbtiles://./tiles.mbtiles

Render a TM2 style for a small area into an MBTiles archive:

npm install -g mbtiles tilelive-tmstyle tilelive-mapbox tilejson \
  tilelive-vector@^0.13.0
tl copy 
  -z 6 -Z 6 -b "-124.4096 32.5343 -114.1308 42.0095" \
  tmstyle://./project.tm2/ mbtiles://./tiles.mbtiles

Render a static image using the rendered tiles:

tl render
  -z 6 -b "-123 37 -122 38" \
  mbtiles://./tiles.mbtiles \
  -o image.png

(This would also work if you used the tmstyle source, but the tiles would be rendered in the interim.)

Caveats

Some tilelive providers use other providers but don't depend on them directly (relying on tilelive.load()), so you may need to install (and --require|-r) some modules that you're not using directly.

For example, tilelive-tmstyle often loads data using tilelive-mapbox, which actually uses tilejson under the hood to do the fetching. Rendering is then done using tilelive-vector (which is declared as a peer dependency of tilelive-tmstyle, so versions may not always match up to whatever's most up-to-date).