# vector-tile

> Parses vector tiles

Latest version **1.3.0** (published 2016-07-19) · BSD license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install vector-tile
pnpm add vector-tile
yarn add vector-tile
bun add vector-tile
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 1.3.0 |
| Published | 2016-07-19 |
| First published | 2014-04-13 |
| Weekly downloads | 0 |
| License | BSD |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 405 |
| Maintainers | aaronlidman, ajashton, ansis, bsudekum, camilleanne, dnomadb, dthompson, gretacb, ian29, ianshward, ingalls, jfirebaugh, karenzshea, kkaefer, lbud, lxbarth, mapbox-admin, miccolis, mikemorris, morganherlocker, mourner, nickidlugash, rclark, samanbb, sgillies, springmeyer, tmcw, tristen, willwhite |

## Links

- npm: https://www.npmjs.com/package/vector-tile
- Repository: https://github.com/mapbox/vector-tile-js
- Homepage: https://github.com/mapbox/vector-tile-js#readme
- Issues: https://github.com/mapbox/vector-tile-js/issues
- npm.io page: https://npm.io/package/vector-tile

## Dependencies (1)

- [point-geometry](https://npm.io/package/point-geometry.md) 0.0.0

## Recent versions

- 1.3.0 (latest) — 2016-07-19
- 1.2.1 — 2016-05-18
- 1.2.0 — 2015-12-10
- 1.1.3 — 2015-06-15
- 1.1.2 — 2015-03-05
- 1.1.1 — 2015-02-25
- 1.1.0 — 2015-02-21
- 1.0.0 — 2014-12-26
- 0.1.3 — 2014-12-09
- 0.1.2 — 2014-08-01
- 0.1.1 — 2014-06-27
- 0.1.0 — 2014-06-27
- 0.0.5 — 2014-06-24
- 0.0.4 — 2014-06-24
- 0.0.3 — 2014-06-24
- … 2 more at https://npm.io/package/vector-tile/versions

## README

# vector-tile

[![build status](https://secure.travis-ci.org/mapbox/vector-tile-js.svg)](http://travis-ci.org/mapbox/vector-tile-js) [![Coverage Status](https://coveralls.io/repos/mapbox/vector-tile-js/badge.svg)](https://coveralls.io/r/mapbox/vector-tile-js)

This library reads [Mapbox Vector Tiles](https://github.com/mapbox/vector-tile-spec) and allows access to the layers and features.

## Example

```js
var VectorTile = require('vector-tile').VectorTile;
var Protobuf = require('pbf');

var tile = new VectorTile(new Protobuf(data));

// Contains a map of all layers
tile.layers;

var landuse = tile.layers.landuse;

// Amount of features in this layer
landuse.length;

// Returns the first feature
landuse.feature(0);
```

Vector tiles contained in [serialtiles-spec](https://github.com/mapbox/serialtiles-spec)
are gzip-encoded, so a complete example of parsing them with the native
zlib module would be:

```js
var VectorTile = require('vector-tile').VectorTile;
var Protobuf = require('pbf');
var zlib = require('zlib');

zlib.gunzip(data, function(err, buffer) {
    var tile = new VectorTile(new Protobuf(buffer));
});
```

## Depends

 - Node.js v0.10.x or v0.8.x


## Install

To install:

    npm install vector-tile


## API Reference


### VectorTile

An object that parses vector tile data and makes it readable.

#### Constructor

- **new VectorTile(protobuf[, end])** —
  parses the vector tile data contained in the given [Protobuf](https://github.com/mapbox/pbf) object,
  saving resulting layers in the created object as a `layers` property. Optionally accepts end index.

#### Properties

- **layers** (Object) &mdash; an object containing parsed layers in the form of `{<name>: <layer>, ...}`,
where each layer is a `VectorTileLayer` object.


### VectorTileLayer

An object that contains the data for a single vector tile layer.

#### Properties

- **version** (`Number`, default: `1`)
- **name** (`String) `&mdash; layer name
- **extent** (`Number`, default: `4096`) &mdash; tile extent size
- **length** (`Number`) &mdash; number of features in the layer

#### Methods

- **feature(i)** &mdash; get a feature (`VectorTileFeature`) by the given index from the layer.


### VectorTileFeature

An object that contains the data for a single feature.

#### Properties

- **type** (`Number`) &mdash; type of the feature (also see `VectorTileFeature.types`)
- **extent** (`Number`) &mdash; feature extent size
- **id** (`Number`) &mdash; feature identifier, if present
- **properties** (`Object`) &mdash; object literal with feature properties

#### Methods

- **loadGeometry()** &mdash; parses feature geometry and returns an array of
  [Point](https://github.com/mapbox/point-geometry) arrays (with each point having `x` and `y` properties)
- **bbox()** &mdash; calculates and returns the bounding box of the feature in the form `[x1, y1, x2, y2]`
- **toGeoJSON(x, y, z)** &mdash; returns a GeoJSON representation of the feature. (`x`, `y`, and `z` refer to the containing tile's index.)

---
_Source: https://npm.io/package/vector-tile · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._