vt-geojson
Stream GeoJSON from Mapbox vector tiles.
Last updated 5 years ago by anandthakker .
BSD · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install vt-geojson 
SYNC missed versions from official npm registry.

vt-geojson

js-standard-style

Build Status

Extract GeoJSON from Mapbox vector tiles.

Usage

CLI

Install with npm install -g vt-geojson, and then:

vt-geojson /path/to/tiles.mbtiles --bounds minx miny maxx maxy
cat bounding_polygon.geojson | vt-geojson tilejson+http://api.tiles.mapbox.com/v4/YOUR-MAPID?access_token=YOUR_MAPBOX_TOKEN -z 12
vt-geojson someone.blahblah --tile tilex tiley tilez # ('someone.blahblah' is a mapid)

Node

First npm install vt-geojson and then:

var cover = require('tile-cover')
var vtGeoJson = require('vt-geojson')

var polygon = JSON.parse(fs.readFileSync('my-polygon.geojson'))
var source = 'tilejson+http://api.tiles.mapbox.com/v4/YOUR-MAPID?access_token=YOUR_MAPBOX_TOKEN'

// get an array of tiles ([x, y, z]) that we want to pull data from.
var tiles = cover.tiles(polygon.geometry, { min_zoom: 10, max_zoom: 12 })

// stream geojson from the chosen tiles:
vtGeoJson(source, tiles)
  .on('data', function (feature) {
    console.log("it's a GeoJSON feature!", feature.geometry.type, feature.properties)
  })
  .on('end', function () {
    console.log('all done')
  })

Browser

This module should work with browserify. There's a minimal example of using it in the browser here. Try it with:

npm install -g budo
budo example/browser.js

Then go to http://localhost:9966/?mapid=mapbox.mapbox-streets-v6&tile=73/97/8&layers=road&access_token=YOUR_MAPBOX_ACCESS_TOKEN

API

vtgeojson

Stream GeoJSON from a Mapbox Vector Tile source

Parameters

  • uri string the tilelive URI for the vector tile source to use.
  • options object options
    • options.layers Array<string> An array of layer names to read from tiles. If empty, read all layers
    • options.tiles Array The tiles to read from the tilelive source. If empty, use options.bounds instead.
    • options.bounds Array The [minx, miny, maxx, maxy] bounds or a GeoJSON Feature, FeatureCollection, or Geometry defining the region to read from source. Ignored if options.tiles is set. If empty, use the bounds from the input source's metadata.
    • options.minzoom number Defaults to the source metadata minzoom. Ignored if options.tiles is set.
    • options.maxzoom number Defaults to the source metadata minzoom. Ignored if options.tiles is set.
    • options.tilesOnly boolean Output [z, y, x] tile coordinates instead of actually reading tiles. Useful for debugging.
    • options.strict boolean Emit an error and end the stream if a tile is not found or can't be read

Returns ReadableStream<Feature> A stream of GeoJSON Feature objects. Emits warning events with { tile, error } when a tile from the requested set is not found or can't be read.

Contributing

This is an OPEN Open Source Project. This means that:

Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit. This project is more like an open wiki than a standard guarded open source project.

Current Tags

  • 2.1.1                                ...           latest (5 years ago)

26 Versions

  • 2.1.1                                ...           5 years ago
  • 2.1.0                                ...           5 years ago
  • 2.0.6                                ...           5 years ago
  • 2.0.5                                ...           5 years ago
  • 2.0.4                                ...           5 years ago
  • 2.0.3                                ...           5 years ago
  • 2.0.2                                ...           5 years ago
  • 2.0.1                                ...           5 years ago
  • 2.0.0                                ...           5 years ago
  • 1.0.16                                ...           5 years ago
  • 1.0.15                                ...           5 years ago
  • 1.0.14                                ...           5 years ago
  • 1.0.13                                ...           5 years ago
  • 1.0.12                                ...           5 years ago
  • 1.0.11                                ...           6 years ago
  • 1.0.10                                ...           6 years ago
  • 1.0.9                                ...           6 years ago
  • 1.0.8                                ...           6 years ago
  • 1.0.7                                ...           6 years ago
  • 1.0.6                                ...           6 years ago
  • 1.0.5                                ...           6 years ago
  • 1.0.4                                ...           6 years ago
  • 1.0.3                                ...           6 years ago
  • 1.0.2                                ...           6 years ago
  • 1.0.1                                ...           6 years ago
  • 1.0.0                                ...           6 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 0
Last Month 2
Dependencies (14)
Dev Dependencies (7)
Dependents (1)

Copyright 2014 - 2016 © taobao.org |