Home

Welcome to the Esri Java Geometry Library wiki!

Esri Java Geometry Library

API Reference

Native Geometry Types

• Polygon
• Polyline
• Point
• MultiPoint
• Envelope

Geometries can have attributes Z, M, ID. All geometries support Affine Transformations in 2D space.

Also included are OGC Wrappers that provide OGC geometry types - OGCPolygon, OGCMultiPolygon, OGCLineString, OGCMultiLineString, OGCPoint, OGCMultiPoint and OGCGeometryCollection.

List of Operations

In geometry-api-java, the geometry is planar with the exception of GeometryEngine.geodesicDistanceOnWGS84. The X/Y values are considered on an infinite plane, and all operations are executed based on that assumption.

Topological operations

Boolean operations on Polygons, Polylines, Points and MultiPoints

• Cut
• Difference
• Intersection
• Symmetric Difference
• Union

Validation

• Simplify - validates and fixes the geometry to be correct for storage in geodatabase
• IsSimple - validates the geometry to be correct for storage in geodatabase
• Simplify with OGC restrictions - validates and fixes the geometry to be correct according to OGC rules
• IsSimple with OGC restrictions - checks if the geometry is correct according to OGC rules

Relational operations

• Relation using DE-9IM matrix
• Contains
• Crosses
• Disjoint
• Equals
• Intersects
• Overlaps
• Touches
• Within

Import/Export operations

• From Esri Shape, To Esri Shape
• From REST Json, To REST Json
• From GeoJson
• From WKT, To WKT
• From WKB, To WKB

Other operations

• Boundary - creates a geometry that is the boundary of a given geometry
• Buffer - creates buffer polygon around the given geometry
• Clip - clips geometries with a 2-dimensional envelope
• Convex Hull - creates the convex hull of a given geometry
• Densify - densifies geometries by plotting points between existing vertices
• Distance - calculates the distance between two geometries
• Generalize - simplifies geometries using the Douglas-Peucker algorithm
• Offset - creates geometries that are offset from the input geometries by a given distance
• Proximity - finds the closest point on a geometry to a given point
• Quadtree structure - can be used for spatial indexing
• Geodesic Distance (see geodesicDistanceOnWGS84 in GeometryEngine) - calculates the shortest distance between two points on the WGS84 spheroid