/terraformer

A geographic toolkit for dealing with geometry, geography, formats, and building geodatabases

Primary LanguageJavaScriptMIT LicenseMIT

@terraformer

npm travis standard

A geographic toolkit for dealing with geometry, geography, formats, and building geodatabases.

Packages

FAQ

What's the difference between this and Esri/Terraformer?

Very little!

This project is a standalone ES Module port of the original Terraformer project without the Primitives.

If you found instantiating Primitives tedious or you'd like to cut down on your bundle size by importing only the code from Terraformer that you're actually using, you should consider upgrading.

I'm already using terraformer. How do I upgrade?

Previously it was necessary to instantiate a Terraformer Primitive in order to execute spatial operations

npm install terraformer
const Terraformer = require('terraformer')

const polygon = new Terraformer.Primitive({
  type: "LineString",
  coordinates: [
    [ 100, 0 ], [ -45, 122 ], [ 80, -60 ]
  ]
})

polygon.convexHull()

Now you'll work directly with raw GeoJSON

npm install @terraformer/spatial
const Terraformer = require('@terraformer/spatial')

Terraformer.convexHull({
  type: "LineString",
  coordinates: [
    [ 100, 0 ], [ -45, 122 ], [ 80, -60 ]
  ]
})
I'm already using terraformer-wkt-parser. How do I upgrade?

Instead of this:

npm install terraformer-wkt-parser
var wkt = require('terraformer-wkt-parser')

// parse a WKT file and turn it into GeoJSON
wkt.parse('LINESTRING (30 10, 10 30, 40 40)')
wkt.convert(/* ... */)

You'll do this:

npm install @terraformer/wkt
const Terraformer = require('@terraformer/wkt')

Terraformer.wktToGeoJSON(/* ... */)
Terraformer.geojsonToWKT(/* ... */)
I'm already using terraformer-arcgis-parser. How do I upgrade?

Instead of this:

npm install terraformer-arcgis-parser
var ArcGIS = require('terraformer-arcgis-parser')

// parse ArcGIS JSON and turn it into GeoJSON
ArcGIS.parse()
ArcGIS.convert()

You'll do this:

npm install @terraformer/wkt
const Terraformer = require('@terraformer/arcgis')

Terraformer.arcgisToGeoJSON(/* ... */)
Terraformer.geojsonToArcGIS(/* ... */)

Contributing

npm install && npm test