Changelog

1.2.0 to 2.0.0

JTS Major Version Upgrade

• Update to new version of JTS hosted by LocationTech org (https://github.com/locationtech/jts and https://mvnrepository.com/artifact/org.locationtech.jts/jts-core/1.15.0)

Note while this change is relatively minor with regard to the outward API for factual/geo, it is considered a major version upgrade because any of the JTS types returned by this library will have moved from the com.vividsolutions namespace to org.locationtech. So users of this library may need to update any type-specific code or imports accordingly.

Proj4 Projection Support

Several new functions have been added to the geo.jts namespace to deal with CRS projections.

• geo.jts operations will default to SRID 4326, but will respect a geometry's existing SRID if set
• geo.jts/transform-geom to convert a JTS Geometry to an alternate CRS.
• geo.jts/get-srid to check the SRID of a JTS Geometry
• geo.jts/set-srid to check the SRID of a JTS Geometry
• geo.jts functions linear-ring, polygon-wkt, and multi-polygon-wkt now accept optional srid arguments for constructing new geometries in the desired SRID
• geo.spatial/to-jts New Shapelike protocol function for converting Shapelikes to JTS geometries. Accepts an optional SRID and defaults to 4326

See geo.crs for some helpers around checking and manipulating CRS reference IDs.

GeoJSON Updates

• geo.io/read-geojson Can now read GeoJSON Features and FeatureCollections. Note that the interface of this has changed somewhat to accommodate the different structures of GeoJSON Geometries, Features, and FeatureCollections. read-geojson will always return a sequence of Feature maps containing :geometry and :properties keys
• Use geo.io/parse-geojson To access the raw GeoJSON entity (Geometry, Feature, or FeatureCollection) if needed
• Use geo.io/to-geojson-feature-collection or geo.io/to-geojson-feature to construct the appropriate GeoJSON from a map containing {:properties {...} :geometry <JTS Geom>}

New Spatial Functions

• geo.spatial/rand-point-in-radius for getting a random point within a given radius of a given center point
• geo.spatial/resegment for partitioning JTS LineStrings into segments of a given max length

Geohash performance improvements

• geo.geohash/geohashes-intersecting has been optimized significantly for tiling large geometries with small geohash levels.

1.2.0 to 1.2.1

• Minor perf improvement from removing a reflection call in our JTSShapeFactoryUsage

1.1.0 to 1.2.0

• Added new spatial function for splitting JTS linestrings into sub-strings based on a desired maximum segment length
• Added JTS functions for working with linestrings more conveniently

1.0.0 to 1.1.0

• Update dependencies, including JTS to 1.13 and Spatial4J to 0.6
• Add new geo.io namespace with functions for reading and writing common geo formats
• Fix intersecting-geohashes edge cases around dateline and origin-crossing geometries