Skip to content

Latest commit

 

History

History
71 lines (48 loc) · 2.21 KB

README.md

File metadata and controls

71 lines (48 loc) · 2.21 KB

jgeohash

An easy-to-implement library that can assist Java developers in using the GeoHash algorithm in order to create geocodes based on custom latitude and longitude values.

With the help of jGeohash, Java developers will be able to quickly and easily generate a geohash code using user-defined latitude and longitude values. By using the GeoHash algorithm, the space can be divided into multiple grid shapes.

This library is a basic implementation from the GeoHash algorithm written in the java and can be applied to generate from the latitude and longitude a geohash code and reverse.

The library is kept simple and have no dependencies to other libraries.

Maven dependency

To add the dependency to your maven project you have to add to the section repositories(in pom.xml or settings.xml) following repository:

<repositories>
	<repository>
		<id>jgeohash-mvn-repo</id>
		<url>https://raw.github.com/astrapi69/jgeohash/mvn-repo/</url>
		<snapshots>
			<enabled>true</enabled>
			<updatePolicy>always</updatePolicy>
		</snapshots>
	</repository>
</repositories>

Than you can add the dependency to your dependencies:

<dependencies>
	<dependency>
		<groupId>jGeohash</groupId>
		<artifactId>jgeohash</artifactId>
		<version>${jgeohash.version}</version>
	</dependency>	
</dependencies>

License

The source code is under the Apache License V2.0 as published by the Apache Foundation.

If you have suggestions or improvements of bugfixes please contribute back via github.

Examples

See the wiki page.

Last changes

Version 1.4.3

Extend functionality to calculate distance from two Points, Positions, coordinate values(latitude, longitude) or two geohash values in meters. Created a new class for keeping data of the neighbors cells from the given geohash to cardinal directions for the first and second ring region.

Version 1.4.2

Added new interface Position for the class Point.

Created new class that calculates distance from two Points or two geohash values in km or miles.

Version 1.4.1

Added method to get getAdjacent from multiply directions.

Added functionality for get first and second ring neighbors from a geohash cell.