UNPKG

terraformer

Version:

A Geo-toolkit built in Javascript.

172 lines (148 loc) 10 kB
<!doctype html> <html> <head> <meta charset="utf-8"> <!-- Always force latest IE rendering engine or request Chrome Frame --> <meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible"> <!-- Use title if it's in the page YAML frontmatter --> <title>Home | Terraformer</title> <!-- Assets --> <link href="/assets/css/terraformer-02847305.css" media="screen" rel="stylesheet" type="text/css" /> <script> if (window.location.href.match('github.io')) { window.location.replace('http://terraformer.io' + window.location.pathname); } </script> </head> <body id="wrap"> <nav> <ul> <li> <a href="/" class="">Terraformer</a> </li> <li> <a href="https://github.com/search?q=%40Esri+terraformer" class="">GitHub</a> </li> <li> <a href="/install" class="">Install</a> </li> <li> <a href="/" data-direction="active-top" class="toggle" id="close-drawer">Docs</a> </li> </ul> </nav> <div class="drawer" id="drawer"> <div class="doctoc drawer-nav drawer-top"> <div class="container"> <ul> <h3>Terraformer Documentation</h3> <li><a href="/getting-started/">Getting Started</a></li> <li><a href="/core/">Terraformer Core</a></li> <li class="indent"><a href="/core/#terraformerprimitive">Primitives</a></li> <li class="indent"><a href="/core/#terraformertools">Tools</a></li> <li><a href="/geostore/">GeoStores</a></li> <li class="indent"><a href="/geostore/data-stores/">DataStores</a></li> <li class="indent"><a href="/geostore/spatial-indexes/">Spatial Indexes</a></li> <li><a href="/arcgis-parser/">ArcGIS Parser</a></li> <li><a href="/wkt-parser/">WKT Parser</a></li> <li><a href="/glossary/">Glossary</a></li> </ul> </div> </div> </div> <header class="cover"> <section> <h1><span class="icon terraformer">terraformer</span></h1> <h2>A thing that does stuff to your data so you can map gooder.</h2> <div class="cover-actions"> <a href="/getting-started/" class="button button-light">Getting Started</a> <a href="/install/" class="button button-light">Get Terraformer</a> </div> </section> </header> <main class="index main-content" id="main-content"> <header class="subhead"> <img src="assets/images/terraformer-core-93b83c36.png" alt="terraformer core"> <h2>Terraformer Core</h2> <h3> <a href="/core/" class="button button-light">Documentation</a> <a href="/install/#terraformer-core" class="button button-light">Get Core</a> </h3> </header> <blockquote> <p>Tools and objects for working with and transforming GeoJSON.</p> </blockquote> <p>The core Terraformer library provides a series of <code>Terraformer.Primitives</code> which wrap GeoJSON objects for additional functionality and a series of <code>Terraformer.Tools</code> for manipulating and performing calculations on coordinates.</p> <p>You can also use the core library to see if an object contains or intersects another object, convert an object to a different spatial reference, or transform an object&rsquo;s coordinates.</p> <p>The core library is also used in most other components of Terraformer for performing basic tasks and calculations.</p> <header class="subhead"> <img src="assets/images/terraformer-geostore-9e09ce2c.png" alt="terraformer geostore"> <h2>GeoStore</h2> <h3> <a href="/geostore/" class="button button-light">Documentation</a> <a href="/install/#geostore" class="button button-light">Get GeoStore</a> </h3> </header> <blockquote> <p>A lightweight API that allows you to store, index and query geographic data.</p> </blockquote> <p>GeoStore is a lightweight API that allows you to store, index and query geographic data with a variety of indexes and persistence methods. Each GeoStore consists of&hellip;</p> <ol> <li><p>A <em>spatial index</em> which is responsible for indexing and optimizing the geographic data in the store.</p></li> <li><p>A <em>data store</em> which is responsible for persisting data, either holding it in memory or persisting it to a backend database.</p></li> <li><p>Any number of <em>secondary indexes</em> which index properties associated with your geographic data.</p></li> </ol> <header class="subhead"> <img src="assets/images/terraformer-arcparser-a0228324.png" alt="terraformer ArcGIS Parser"> <h2>ArcGIS Parser</h2> <h3> <a href="/arcgis-parser/" class="button button-light">Documentation</a> <a href="/install/#arcgis-parser" class="button button-light">Get ArcGIS Parser</a> </h3> </header> <p>Allows you to convert between <a href="/core/#terraformerprimitive">Terraformer Primitives</a> or <a href="http://geojson.org/geojson-spec.html">GeoJSON</a> and the <a href="http://resources.arcgis.com/en/help/arcgis-rest-api/#/Geometry_Objects/02r3000000n1000000/">ArcGIS Geometry Objects</a>.</p> <pre class="highlight javascript"><code><span class="c1">// parse ArcGIS JSON, convert it to a Terraformer.Primitive</span> <span class="kd">var</span> <span class="nx">primitive</span> <span class="o">=</span> <span class="nx">Terraformer</span><span class="p">.</span><span class="nx">ArcGIS</span><span class="p">.</span><span class="nx">parse</span><span class="p">({</span> <span class="na">x</span><span class="p">:</span><span class="s2">"-122.6764"</span><span class="p">,</span> <span class="na">y</span><span class="p">:</span><span class="s2">"45.5165"</span><span class="p">,</span> <span class="na">spatialReference</span><span class="p">:</span> <span class="p">{</span> <span class="na">wkid</span><span class="p">:</span> <span class="mi">4326</span> <span class="p">}</span> <span class="p">});</span> <span class="c1">// take a Terraformer.Primitive or GeoJSON and convert it to ArcGIS JSON</span> <span class="kd">var</span> <span class="nx">point</span> <span class="o">=</span> <span class="nx">Terraformer</span><span class="p">.</span><span class="nx">ArcGIS</span><span class="p">.</span><span class="nx">convert</span><span class="p">({</span> <span class="s2">"type"</span><span class="p">:</span> <span class="s2">"Point"</span><span class="p">,</span> <span class="s2">"coordinates"</span><span class="p">:</span> <span class="p">[</span><span class="mf">45.5165</span><span class="p">,</span> <span class="o">-</span><span class="mf">122.6764</span><span class="p">]</span> <span class="p">});</span> </code></pre> <header class="subhead"> <img src="assets/images/terraformer-wktparser-b18bc9d9.png" alt="terraformer WKT Parser"> <h2>Well Known Text Parser</h2> <h3> <a href="/wkt-parser/" class="button button-light">Documentation</a> <a href="/install/#wkt-parser" class="button button-light">Get WKT Parser</a> </h3> </header> <p><a href="http://en.wikipedia.org/wiki/Well-known_text">Well Known Text</a> is a format used by databases like PostGIS. With Terraformer&rsquo;s WKT parser you can convert between this format and GeoJSON.</p> <pre class="highlight javascript"><code><span class="c1">// parse a WKT file, convert it into a primitive</span> <span class="kd">var</span> <span class="nx">primitive</span> <span class="o">=</span> <span class="nx">Terraformer</span><span class="p">.</span><span class="nx">WKT</span><span class="p">.</span><span class="nx">parse</span><span class="p">(</span><span class="s1">'LINESTRING (30 10, 10 30, 40 40)'</span><span class="p">);</span> <span class="c1">// take a primitive and convert it into a WKT representation</span> <span class="kd">var</span> <span class="nx">polygon</span> <span class="o">=</span> <span class="nx">Terraformer</span><span class="p">.</span><span class="nx">WKT</span><span class="p">.</span><span class="nx">convert</span><span class="p">({</span> <span class="s2">"type"</span><span class="p">:</span> <span class="s2">"Polygon"</span><span class="p">,</span> <span class="s2">"coordinates"</span><span class="p">:</span> <span class="p">[</span> <span class="p">[</span> <span class="p">[</span><span class="mf">100.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">],</span> <span class="p">[</span><span class="mf">101.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">],</span> <span class="p">[</span><span class="mf">101.0</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">],</span> <span class="p">[</span><span class="mf">100.0</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">],</span> <span class="p">[</span><span class="mf">100.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">]</span> <span class="p">],</span> <span class="p">[</span> <span class="p">[</span><span class="mf">100.2</span><span class="p">,</span> <span class="mf">0.2</span><span class="p">],</span> <span class="p">[</span><span class="mf">100.8</span><span class="p">,</span> <span class="mf">0.2</span><span class="p">],</span> <span class="p">[</span><span class="mf">100.8</span><span class="p">,</span> <span class="mf">0.8</span><span class="p">],</span> <span class="p">[</span><span class="mf">100.2</span><span class="p">,</span> <span class="mf">0.8</span><span class="p">],</span> <span class="p">[</span><span class="mf">100.2</span><span class="p">,</span> <span class="mf">0.2</span><span class="p">]</span> <span class="p">]</span> <span class="p">]</span> <span class="p">});</span> </code></pre> </main> <footer> <p> Terraformer is an open source project from the <a href="http://pdx.esri.com/">Esri Portland R&amp;D Center</a> </p> </footer> </body> <script src="/assets/javascripts/modernizr.custom-cadc78a2.js" type="text/javascript"></script> <script src="/assets/javascripts/classie-b6db1f70.js" type="text/javascript"></script> <script src="/assets/javascripts/drawer-3a1490eb.js" type="text/javascript"></script> </html>