Home

Sergey Tolstov edited this page Sep 8, 2017 · 35 revisions
Clone this wiki locally

Welcome to the Esri Java Geometry Library wiki!

Esri Java Geometry Library

API Reference

Samples @ https://github.com/Esri/samples-geometry-api-java

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.

Accelerators

  • Certain operations can be accelerated to perform faster when a geometry instance is used over and over. This is achieved using the Operator's accelerateGeometry method. Depending on the acceleration degree, the acceleration builds and attaches to the geometry a quad tree and/or a rasterized representation (a hit map). Presently, some relational operators and some topological operators benefit from the acceleration.

Tolerance

  • Relational, Topological, Validation, and some other operators use XY tolerance (aka cluster tolerance) in processing. The tolerance is used to set the minimum distance between coordinates below which the coordinates are considered equal. The tolerance value is derived from the SpatialReference instance and is around 1 mm. This value should match the default value of tolerance in Geodatabase. When SpatialReference instance is not provided (null), the operators use a small value derived from the bounding box of the geometries participating in the operation. The OperatorSimplify, when used together with a SpatialReference instance, will enforce the tolerance value thus ensuring validity of the generated geometry for storing with Geodatabase.