terraformer
Version:
A Geo-toolkit built in Javascript.
172 lines (148 loc) • 10 kB
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’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…</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’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&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>