isabella232 / geometry-api-java

The Esri Geometry API for Java enables developers to write custom applications for analysis of spatial data. This API is used in the Esri GIS Tools for Hadoop and other 3rd-party data processing solutions.

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. To build the jar, run the mvn compile command-line command from within the cloned directory.
3. Deploy the esri-geometry-api.jar to the target system, add a reference to it in a Java project.
4. To run the unit-tests, run the mvn test command-line command from within the cloned directory.

The project is also available as a Maven dependency:

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

Requirements

• Java JDK 1.6 or greater.
• Apache Maven 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-2019 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.