Skip to content

Latest commit

 

History

History
48 lines (33 loc) · 1.9 KB

README.md

File metadata and controls

48 lines (33 loc) · 1.9 KB

Introduction

SimpleLatLng provides a simple, lightweight library for common latitude and longitude calculation needs in Java.

With this library, you get the following:

  1. an object to represent a Latitude/Longitude point,
  2. methods to calculate the approximate distance between two points,
  3. classes that specify windows of varying shapes for testing whether or not a point lies within the window,
  4. a Geohash implementation.

In short, if you have looked at other geo-spatial libraries in Java and thought "this is way more than I need", this library might be for you!

Usage

See the wiki for basic usage.

License

SimpleLatLng is licensed through the commercial-friendly Apache 2.0 License

Download

Binaries can be downloaded directly from the releases page.

SimpleLatLng is also available from the Maven central repositories:

<dependency>
  <groupId>com.javadocmd</groupId>
  <artifactId>simplelatlng</artifactId>
  <version>RELEASE</version>
</dependency>

Disclaimer

At this point no claims are made as to the accuracy of the calculations provided by this library. They are based upon approximations and your results may differ from tested results. However, this project makes a best effort to produce results that are "good enough" for most uses, and/or tune-able for your particular circumstances. The only suggestion is that you independently evaluate the results of this code for your use-case before relying upon it in a production environment.

If you would like to contribute to the correctness of the code or the battery of tests it is run through, the project founder would greatly appreciate it.