tippecanoe/README.md

tippecanoe
==========

Build vector tilesets from large collections of GeoJSON features.

Usage
-----

    tippecanoe -o file.mbtiles [file.json]

If the file is not specified, it reads GeoJSON from the standard input.

Options
-------

 * -l Layer name (default "file" if source is file.json)
 * -n Human-readable name (default file.json)
 * -z Base zoom level (default 14)
 * -Z Lowest zoom level (default 0)
 * -d Detail at base zoom level (default 12, for tile resolution of 4096)
 * -D Detail at lower zoom levels (default 10, for tile resolution of 1024) 

Example
-------

    tippecanoe -o alameda.mbtiles -l alameda -n "Alameda County from TIGER" -z12 -d14 tl_2014_06001_roads.json

Geometric simplifications
-------------------------

For point features, it drops 1/2.5 of the dots for each zoom level above the base.
I don't know why 2.5 is the appropriate number, but the densities of many different
data sets fall off at about this same rate.

For line features, it drops any features that are too small to draw at all.
This still leaves the lower zooms too dark, so I need to figure out an
equitable way to throw features away.

It also throws away any polygons that are too small to draw. I'm not sure yet
if it is appropriate to do more than that.

Development
-----------

Requires protoc, protobuf-lite, and sqlite3. To build:

    make

and perhaps

    make install