# Lucene 3.4.0 contrib-spatial API

This package makes it possible to filter and sort according to geographical constraints.

See:
Description

Packages
org.apache.lucene.spatial
org.apache.lucene.spatial.geohash: Support for Geohash encoding, decoding, and filtering.
org.apache.lucene.spatial.geometry
org.apache.lucene.spatial.geometry.shape
org.apache.lucene.spatial.tier: Support for filtering based upon geographic location.
org.apache.lucene.spatial.tier.projections

This package makes it possible to filter and sort according to geographical constraints. For example, filter to include only restaurants within 2 miles of a specified latitude/longitude, sorting by distance ascending.

See here for details on the technical approach.

Unfortunately, this package is still very new, and has little to no documentation. It's best to ask for pointers on java-user@lucene.apache.org, and look at the unit tests included in the source distribution.

There are also known issues, eg at least LUCENE-1781 and LUCENE-1815.

NOTE: This package is still in flux and might change in incompatible ways in the next release.

Copyright © 2000-2011 Apache Software Foundation. All Rights Reserved.