geometry-api-java

The Esri Geometry API for Java can be used to enable spatial data processing in 3rd-party data-processing solutions. Developers of custom MapReduce-based applications for Hadoop can use this API for spatial processing of data in the Hadoop system. The API is also used by the Hive UDF’s and could be used by developers building geometry functions for 3rd-party applications such as Cassandra, HBase, Storm and many other Java-based “big data” applications.

Features

• API methods to create simple geometries directly with the API, or by importing from supported formats: JSON, WKT, and Shape
• API methods for spatial operations: union, difference, intersect, clip, cut, and buffer
• API methods for topological relationship tests: equals, within, contains, crosses, and touches

Instructions

Building the source:

1. Download and unzip the .zip file, or clone the repository.
2. Deploy the esri-geometry-api.jar to the target system, add a reference to it in a Java project.
3. To build the jar, Javadoc, and run the unit-tests, run the “ant” command-line command from within the cloned directory. The ant tool runs the “build.xml” script which creates the jar, runs the unit tests, then creates the Javadoc documentation files.

The project is also available as a Maven dependency:

<dependency>
  <groupId>com.esri.geometry</groupId>
  <artifactId>esri-geometry-api</artifactId>
  <version>2.0.0</version>
</dependency>

Requirements

• Java JDK 1.6 or greater.
• Apache Ant build system.
• Experience developing MapReduce applications for Apache Hadoop.
• Familiarity with text-based spatial data formats such as JSON or WKT would be useful.

Documentation

• geometry-api-java/Wiki
• geometry-api-java/Javadoc

Resources

• ArcGIS Geodata Resource Center
• ArcGIS Blog
• twitter@esri

Issues

Find a bug or want to request a new feature? Please let us know by submitting an issue.

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing

Licensing

Copyright 2013-2018 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's license.txt file.