Skip to content

terraformer-js/terraformer

main
Switch branches/tags
Code

@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(/* ... */)
What about terraformer-geostore?

This repo does not include a port of https://github.com/Esri/terraformer-geostore and there is no plan to tackle it in the future.

Since terraformer-geostore ingests plain ol' GeoJSON, you're welcome to keep on using the original code.

Contributing

npm install && npm test

About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published