README.md

Jackson-datatype-jts

Jackson Module which provides custom serializers and deserializers for JTS Geometry objects using the GeoJSON format

Installation

Releases of jackson-datatype-jts are available on Maven Central.

Maven

To use the module in Maven-based projects, use following dependency:

<dependency>
  <groupId>com.graphhopper.external</groupId>
  <artifactId>jackson-datatype-jts</artifactId>
  <version>[latest]</version>
</dependency>    

GraphHopper updates on branch gh:

• 0.10-2.5-2 new groupId com.graphhopper.external and introduced JTS 1.15.0
• 0.12-2.5-0 with the original jackson-databind dependency 2.4.2 and JTS 1.15.1
• 0.12-2.5-1 with jackson-databind 2.9.6
• 1.0-2.7 with jackson-databind 2.9.9 and JTS 1.16.0

Gradle

dependencies {
    compile 'com.graphhopper.external:jackson-datatype-jts:[latest]'
}

Usage

Registering module

To use JTS geometry datatypes with Jackson, you will first need to register the module first (same as with all Jackson datatype modules):

ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JtsModule());

Reading and Writing Geometry types

After registering JTS module, Jackson Databind will be able to write Geometry instances as GeoJSON and and read GeoJSON geometries as JTS Geometry objects.

To write a Point object as GeoJSON:

GeometryFactory gf = new GeometryFactory();
Point point = gf.createPoint(new Coordinate(1.2345678, 2.3456789));
String geojson = objectMapper.writeValueAsString(point);

You can also read GeoJSON in as JTS geometry objects:

InputStream in;
Point point = mapper.readValue(in, Point.class);