# spatial-framework-for-hadoop

**Repository Path**: lidong091/spatial-framework-for-hadoop

## Basic Information

- **Project Name**: spatial-framework-for-hadoop
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-04-01
- **Last Updated**: 2021-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![Build Status](https://travis-ci.org/Esri/spatial-framework-for-hadoop.png?branch=master)](https://travis-ci.org/Esri/spatial-framework-for-hadoop)
# spatial-framework-for-hadoop

The __Spatial Framework for Hadoop__ allows developers and data scientists to use the Hadoop data processing system 
for spatial data analysis.

For tools, [samples](https://github.com/Esri/gis-tools-for-hadoop/tree/master/samples), and [tutorials](https://github.com/Esri/gis-tools-for-hadoop/wiki) that use this framework, head over 
to [GIS Tools for Hadoop](https://github.com/Esri/gis-tools-for-hadoop).

## What's New

* ST_Centroid now returns the geometry centroid rather than the center of its envelope (as of v2.1).
* [Spatial Framework for Hadoop v2](https://github.com/Esri/spatial-framework-for-hadoop/releases) is compatible with [Geometry v2](https://github.com/Esri/geometry-api-java/releases), Hive v2.3 & v3, and Jackson v2.  Note: up-to-date releases may be available [on Github](https://github.com/Esri/spatial-framework-for-hadoop/releases) but [not on Maven Central](https://github.com/Esri/spatial-framework-for-hadoop/issues/123).

## Features

* **[JSON Utilities](https://github.com/Esri/spatial-framework-for-hadoop/wiki/JSON-Utilities)** - Utilities 
for interacting with JSON exported from ArcGIS
 * [Javadoc](http://esri.github.com/spatial-framework-for-hadoop/json/)
* **[Hive Spatial](https://github.com/Esri/spatial-framework-for-hadoop/wiki/Hive-Spatial)** - User-Defined 
Functions and SerDes for spatial analysis in Hive
 * [UDF Documentation](https://github.com/Esri/spatial-framework-for-hadoop/wiki/UDF-Documentation)
 * [JSON SerDe](https://github.com/Esri/spatial-framework-for-hadoop/wiki/Hive-JSON-SerDe)

## Getting Started

### Maven

Build as you would any other Mavenized repository.  All dependencies are pulled automatically. 

### Ant

Ant build files are also available

At the root level of this repository, you can build a single jar with everything in the framework 
using [Apache Ant](http://ant.apache.org/).  Alternatively, you can build a jar at the root level of each 
framework component (i.e., `hive/build.xml`).

The build files use [Maven Ant Tasks](http://maven.apache.org/ant-tasks/download.html) for dependency 
management. You will need the jar in a place Ant can find it (i.e., `~/.ant/lib/maven-ant-tasks-2.1.3.jar`).


## Dependencies

* [Esri Geometry API for Java](https://github.com/Esri/geometry-api-java) - Java geometry library for spatial data 
processing.

## Requirements

* Geometry 2.0
* Hive 0.11 and above (see [Hive Compatibility issues](https://github.com/Esri/spatial-framework-for-hadoop/wiki/ST_Geometry-for-Hive-Compatibility-with-Hive-Versions))  (For building from source, Hive-0.12+ is required.)
* Workflows calling MapReduce jobs require the location of the custom job to be run.
* Custom MapReduce jobs that use the Esri Geometry API require that the developer has authored the job, 
(referencing the com.esri.geometry.\* classes), and deployed the job Jar file to the Hadoop system, prior to the 
ArcGIS user submitting the workflow file. 

## Resources

* [GeoData Blog on the ArcGIS Blogs](http://blogs.esri.com/esri/arcgis/author/jonmurphy/)
* [Big Data Place on GeoNet](https://geonet.esri.com/groups/big-data)
* [ArcGIS Geodata Resource Center]( http://resources.arcgis.com/en/communities/geodata/)
* [ArcGIS Blog](http://blogs.esri.com/esri/arcgis/)
* [twitter@esri](http://twitter.com/esri)

## Issues

Find a bug or want to request a new feature?  Please let us know by submitting an [issue](https://github.com/Esri/spatial-framework-for-hadoop/issues).

## Contributing

Esri welcomes contributions from anyone and everyone. Please see our [guidelines for contributing](https://github.com/esri/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](https://raw.github.com/Esri/spatial-framework-for-hadoop/master/license.txt) file.