Build vector tilesets from large collections of GeoJSON features.
Go to file
2014-09-26 14:51:29 -07:00
geojson.c Restrict to one input file, since that's all that will work 2014-09-26 14:33:03 -07:00
jsoncat.c Remember return value from main() 2014-02-19 17:11:56 -08:00
jsonpull.c Preserve the original string representation of numbers too. 2014-02-26 17:01:30 -08:00
jsonpull.h Clean up after errors and fix related bugs: 2014-02-08 09:31:49 -08:00
LICENSE.md Add license 2014-02-08 10:33:57 -08:00
Makefile Start putting data into mbtiles instead of separate files 2014-09-25 15:20:17 -07:00
README.md Correct example 2014-09-26 14:51:19 -07:00
tile.cc Remember to finalize statements 2014-09-26 14:51:29 -07:00
tile.h Actually write tiles directly to the .mbtiles file! 2014-09-25 16:34:17 -07:00
vector_tile.proto Add vector tile boilerplate 2014-09-22 10:45:34 -07:00

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.

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