geojson-vt
Version:
Slice GeoJSON data into vector tiles efficiently
33 lines (24 loc) • 1.12 kB
Markdown
A highly efficient JavaScript library for slicing GeoJSON data
into [vector tiles](https://github.com/mapbox/vector-tile-spec/)
(or rather their JSON equivalent) on the fly,
primarily for rendering purposes.
Created to power GeoJSON rendering in [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js),
but can be useful for other data visualization purposes.
```js
// build an initial index of tiles
var tileIndex = geojsonvt(geoJSON, {
baseZoom: 14, // max zoom to preserve detail on
maxZoom: 14, // zoom to slice down on first pass
maxPoints: 100, // during first pass, stop slicing each tile below this number of points
debug: 0 // debug level: 1 = some timing info; 2 = individual tiles timing;
});
// request a particular tile
var features = tileIndex.getTile(z, x, y).features;
```
To see a **geojson-vt** in action, run `npm run build-dev`,
then open `debug/index.html` in your browser and drag any GeoJSON on the page.
It was tested on files up to 100Mb:
