Nucleic Photon Magnetizer

    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/geojson-vt package

    3.2.1 • Public • Published

    geojson-vt — GeoJSON Vector Tiles

    Build Status Coverage Status

    A highly efficient JavaScript library for slicing GeoJSON data into vector tiles on the fly, primarily designed to enable rendering and interacting with large geospatial datasets on the browser side (without a server).

    Created to power GeoJSON in Mapbox GL JS, but can be useful in other visualization platforms like Leaflet and d3, as well as Node.js server applications.

    Resulting tiles conform to the JSON equivalent of the vector tile specification. To make data rendering and interaction fast, the tiles are simplified, retaining the minimum level of detail appropriate for each zoom level (simplifying shapes, filtering out tiny polygons and polylines).

    Read more on how the library works on the Mapbox blog.

    There's a C++11 port: geojson-vt-cpp


    Here's geojson-vt action in Mapbox GL JS, dynamically loading a 100Mb US zip codes GeoJSON with 5.4 million points:

    There's a convenient debug page to test out geojson-vt on different data. Just drag any GeoJSON on the page, watching the console.


    // build an initial index of tiles
    var tileIndex = geojsonvt(geoJSON);
    // request a particular tile
    var features = tileIndex.getTile(z, x, y).features;
    // show an array of tile coordinates created so far
    console.log(tileIndex.tileCoords); // [{z: 0, x: 0, y: 0}, ...]


    You can fine-tune the results with an options object, although the defaults are sensible and work well for most use cases.

    var tileIndex = geojsonvt(data, {
        maxZoom: 14,  // max zoom to preserve detail on; can't be higher than 24
        tolerance: 3, // simplification tolerance (higher means simpler)
        extent: 4096, // tile extent (both width and height)
        buffer: 64,   // tile buffer on each side
        debug: 0,     // logging level (0 to disable, 1 or 2)
        lineMetrics: false, // whether to enable line metrics tracking for LineString/MultiLineString features
        promoteId: null,    // name of a feature property to promote to Cannot be used with `generateId`
        generateId: false,  // whether to generate feature ids. Cannot be used with `promoteId`
        indexMaxZoom: 5,       // max zoom in the initial tile index
        indexMaxPoints: 100000 // max number of points per tile in the index

    By default, tiles at zoom levels above indexMaxZoom are generated on the fly, but you can pre-generate all possible tiles for data by setting indexMaxZoom and maxZoom to the same value, setting indexMaxPoints to 0, and then accessing the resulting tile coordinates from the tileCoords property of tileIndex.

    The promoteId and generateId options ignore existing id values on the feature objects.

    GeoJSON-VT only operates on zoom levels up to 24.


    Install using NPM (npm install geojson-vt) or Yarn (yarn add geojson-vt), then:

    // import as a ES module
    import geojsonvt from 'geojson-vt';
    // or require in Node / Browserify
    const geojsonvt = require('geojson-vt');

    Or use a browser build directly:

    <script src=""></script>


    npm i geojson-vt

    DownloadsWeekly Downloads






    Unpacked Size

    71.1 kB

    Total Files


    Last publish


    • mbx-npm-ci-production
    • mbx-npm-ci-staging
    • mbx-npm-advanced-actions-production
    • mbx-npm-advanced-actions-staging
    • mbx-npm-09-production
    • mbx-npm-08-production
    • mbx-npm-07-production
    • mbx-npm-06-production
    • mbx-npm-05-production
    • mbx-npm-04-production
    • mbx-npm-03-production
    • mbx-npm-02-production
    • mbx-npm-01-production
    • mbx-npm-02-staging
    • mapbox-npm-01
    • mapbox-npm-02
    • mapbox-npm-07
    • mapbox-npm-03
    • mapbox-npm-04
    • mapbox-npm-09
    • mapbox-npm-05
    • mapbox-npm-06
    • mapbox-npm-08
    • mapbox-npm-advanced-actions
    • mapbox-npm-ci
    • mapbox-npm
    • mapbox-admin
    • mapbox-machine-user
    • mourner