JavaScript Topology Suite
JavaScript HTML
Latest commit 7584489 Jul 6, 2016 @bjornharrtell Fix manual tests

README.md

JSTS

Build Status Coverage Status

JSTS is an ECMAScript 2015 library of spatial predicates and functions for processing geometry conforming to the Simple Features Specification for SQL published by the Open Geospatial Consortium. JSTS is also a port of the well established Java library JTS.

The primary goal of the project is to provide web mapping applications with a complete library for processing and analyzing simple geometries but JSTS can also be used as a free standing geometry library.

JSTS was made using automatic translation of the original JTS Java source via AST to AST transformation preserving the JTS API, except for the io related classes which has been selectively and manually ported with support for WKT, GeoJSON and OpenLayers 3.

A Google group is available for discussions.

A port of JTS Validation Suite provides additional tests.

Basic functionality together with OpenLayers 3 is demonstrated here.

Browser or Node.js use

An ES5 (the most common JavaScript variant) compatible build for browsers is available here.

Including the above build as a script will import a global object jsts exposing similar public API as org.locationtech.jts in the JTS API.

For Node.js, install using npm install jsts after which require('jsts') will import an object with the same properties as jsts in the browser build.

I/O related classes in JTS had to be manually ported. From the original formats WKT and GeoJSON are supported. A direct reader/writer for OpenLayers 3 geometries exist. See the API documentation for these specific classes.

Caveats

  • In a few cases Java overloading cannot be correctly translated to JavaScript. One such case is createMultiPoint in GeometryFactory which only works with Point[] arguments.