Rule Your Geometry with the Terraformer Toolkit
Download as PPTX, PDF0 likes2,142 views
This document introduces Terraformer, an open source JavaScript library for working with geospatial data. It allows for converting between data formats like GeoJSON, includes tools for geometry operations, and spatial indexing and querying of data. It works both on Node.js servers and in browsers. The document provides examples of using Terraformer to create and manipulate geometries, convert between formats, spatially index and query data, and options for data storage both in browsers and Node.js. Development is ongoing to support additional formats and a Ruby version. Licensing options are also discussed.
![Terraformer: Geometry and Features
// create a typed primitive from GeoJSON
var point = new Terraformer.Primitive({ "type": "Point", "coordinates": [ 100, 1 ] });
// create a Geometry from coordinates or GeoJSON
var point = new Terraformer.Point( [ 10, 10 ] );
var ls = new Terraformer.LineString([ [ 10, 10 ], [ 20, 20 ]]);
var poly = new Terraformer.Polygon([
[[100.0, 0.0], [101.0, 0.0], [101.0, 1.0], [100.0, 1.0]]]);
var circle = new Terraformer.Circle([-122.6764, 45.5165], 1000);
// creates a feature from a valid GeoJSON Object
var feature = new Terraformer.Feature({"type": "Point", "coordinates": [ 10, 10 ]}, "properties":
{"prop0": "value0"});](https://image.slidesharecdn.com/2013terraformerdubaidevsummit-131120035721-phpapp01/85/Rule-Your-Geometry-with-the-Terraformer-Toolkit-4-320.jpg)
![Terraformer: Geometry Operations
// add and remove individual points to geometries
multi.addPoint([ 10, 10 ]);
multi.insertPoint([ 10, 10 ],1);
multi.removePoint(1);
multi.get(1);](https://image.slidesharecdn.com/2013terraformerdubaidevsummit-131120035721-phpapp01/85/Rule-Your-Geometry-with-the-Terraformer-Toolkit-6-320.jpg)
![WKT Conversion
terraformer-wkt-parser.js
// take a WKT representation and convert it into a primative
<script>
var primitive = Terraformer.WKT.parse('LINESTRING (30 10, 10 30, 40 40)');
</script>
// take a primitive and convert it into a WKT representation
var polygon = Terraformer.WKT.convert(
{
"type": "Polygon",
"coordinates": [
[ [100.0, 0.0], [101.0, 0.0], [101.0, 1.0], [100.0, 1.0], [100.0, 0.0] ],
[ [100.2, 0.2], [100.8, 0.2], [100.8, 0.8], [100.2, 0.8], [100.2, 0.2] ]
]
}
);](https://image.slidesharecdn.com/2013terraformerdubaidevsummit-131120035721-phpapp01/85/Rule-Your-Geometry-with-the-Terraformer-Toolkit-10-320.jpg)
![ArcGIS JSON to GeoJSON
terraformer-arcgis-parser.js
<script>
// take ArcGIS JSON and convert to Primitive or GeoJSON
var primitive = Terraformer.ArcGIS.parse({
x:"-122.6764",
y:"45.5165",
spatialReference: {
wkid: 4326
}
});
// take a Primitive or GeoJSON and convert it to ArcGIS JSON
var point = Terraformer.ArcGIS.convert({
"type": "Point",
"coordinates": [45.5165, -122.6764]
});
</script>](https://image.slidesharecdn.com/2013terraformerdubaidevsummit-131120035721-phpapp01/85/Rule-Your-Geometry-with-the-Terraformer-Toolkit-11-320.jpg)
Rule Your Geometry with the Terraformer Toolkit
- 1. Rule Your Geometry with the Terraformer Toolkit Aaron Parecki @aaronpk CTO, Esri R&D Center Portland
- 2. Terraformer Open Source JavaScript Geometry Library
- 3. Terraformer Open source geometry and geodata library Node.js Key and client-side JavaScript features Geometry format conversions (GeoJSON) Geometry operations Coordinate system conversion Store and access data github.com/Esri/Terraformer
- 4. Terraformer: Geometry and Features // create a typed primitive from GeoJSON var point = new Terraformer.Primitive({ "type": "Point", "coordinates": [ 100, 1 ] }); // create a Geometry from coordinates or GeoJSON var point = new Terraformer.Point( [ 10, 10 ] ); var ls = new Terraformer.LineString([ [ 10, 10 ], [ 20, 20 ]]); var poly = new Terraformer.Polygon([ [[100.0, 0.0], [101.0, 0.0], [101.0, 1.0], [100.0, 1.0]]]); var circle = new Terraformer.Circle([-122.6764, 45.5165], 1000); // creates a feature from a valid GeoJSON Object var feature = new Terraformer.Feature({"type": "Point", "coordinates": [ 10, 10 ]}, "properties": {"prop0": "value0"});
- 5. Terraformer: Geometry Operations // output to Web Mercator and WGS84 primitive.toMercator(); primitive.toGeographic();
- 6. Terraformer: Geometry Operations // add and remove individual points to geometries multi.addPoint([ 10, 10 ]); multi.insertPoint([ 10, 10 ],1); multi.removePoint(1); multi.get(1);
- 7. Terraformer: Geometry Operations // compute GeoJSON bounding box bbox = poly.bbox(); // compute x,y,w,h envelope env = polygon.envelope();
- 8. Terraformer: Geometry Operations // Test whether geometries intersect polygon1.within(polygon2); polygon.intersects(line); polygon.contains(point); circle.contains(point);
- 10. WKT Conversion terraformer-wkt-parser.js // take a WKT representation and convert it into a primative <script> var primitive = Terraformer.WKT.parse('LINESTRING (30 10, 10 30, 40 40)'); </script> // take a primitive and convert it into a WKT representation var polygon = Terraformer.WKT.convert( { "type": "Polygon", "coordinates": [ [ [100.0, 0.0], [101.0, 0.0], [101.0, 1.0], [100.0, 1.0], [100.0, 0.0] ], [ [100.2, 0.2], [100.8, 0.2], [100.8, 0.8], [100.2, 0.8], [100.2, 0.2] ] ] } );
- 11. ArcGIS JSON to GeoJSON terraformer-arcgis-parser.js <script> // take ArcGIS JSON and convert to Primitive or GeoJSON var primitive = Terraformer.ArcGIS.parse({ x:"-122.6764", y:"45.5165", spatialReference: { wkid: 4326 } }); // take a Primitive or GeoJSON and convert it to ArcGIS JSON var point = Terraformer.ArcGIS.convert({ "type": "Point", "coordinates": [45.5165, -122.6764] }); </script>
- 13. Terraformer: GeoStore A set of building blocks for managing spatial data as a GeoJSON Feature or FeatureCollection. Includes functionality for storing and querying data spatially. Works server-side (Node.js) and in browsers!
- 15. Terraformer: GeoStore Create a new Store and include both a Data Store and a Spatial Index.
- 16. Terraformer: GeoStore Add objects to the store! More Examples
- 17. Terraformer: GeoStore Query the data store using the “within” method More Examples
- 18. Terraformer: GeoStore Alternate Storage Backends LocalStorage – browser only Memory – browser and Node.js LevelDB – Node.js only Future: ??
- 19. In Progress: Terraformer for Ruby! github.com/esripdx/terraformer-ruby
- 21. Licensing Free ArcGIS Developer Subscription Testing and development Public deployments (non-commercial) 50 credits Paid ArcGIS Developer or ArcGIS Organization Subscription Private deployments Commercial deployments (generates revenue)
- 23. esri.github.com
Editor's Notes
- #2: Esri Corporate Template V2September 6, 2013See http://arczone/resources/presentations.cfm for more sample files and help.
- #8: ----- Meeting Notes (11/20/13 09:22) -----add example output
- #10: ----- Meeting Notes (11/20/13 09:22) -----what's the difference between arcgis json and geojson
- #12: ----- Meeting Notes (11/20/13 09:22) -----can you specify a spatial reference in geojson?
- #17: ----- Meeting Notes (11/20/13 09:22) -----show example of geojson object before adding it to the store with the ID