From ca16a35398b6a67a931479fd012f60cccd27d2fc Mon Sep 17 00:00:00 2001 From: Michael McCandless Date: Thu, 3 Sep 2009 14:03:19 +0000 Subject: [PATCH] LUCENE-1878: make it clear that contrib/spatial is still experimental git-svn-id: https://svn.apache.org/repos/asf/lucene/java/trunk@810951 13f79535-47bb-0310-9956-ffa450edef68 --- .../geohash/GeoHashDistanceFilter.java | 4 +++ .../lucene/spatial/geohash/GeoHashUtils.java | 4 +++ .../spatial/geometry/CartesianPoint.java | 4 +++ .../spatial/geometry/DistanceUnits.java | 5 ++++ .../lucene/spatial/geometry/FixedLatLng.java | 5 ++++ .../lucene/spatial/geometry/FloatLatLng.java | 5 ++++ .../lucene/spatial/geometry/LatLng.java | 5 +++- .../geometry/shape/DistanceApproximation.java | 4 +++ .../spatial/geometry/shape/Ellipse.java | 4 +++ .../spatial/geometry/shape/Geometry2D.java | 4 +++ .../spatial/geometry/shape/IntersectCase.java | 6 +++++ .../lucene/spatial/geometry/shape/LLRect.java | 4 +++ .../spatial/geometry/shape/LineSegment.java | 4 +++ .../spatial/geometry/shape/Point2D.java | 4 +++ .../spatial/geometry/shape/Rectangle.java | 4 +++ .../spatial/geometry/shape/Vector2D.java | 4 +++ .../tier/CartesianPolyFilterBuilder.java | 4 ++- .../spatial/tier/CartesianShapeFilter.java | 5 ++++ .../tier/DistanceFieldComparatorSource.java | 5 ++++ .../lucene/spatial/tier/DistanceFilter.java | 5 ++++ .../lucene/spatial/tier/DistanceHandler.java | 3 +++ .../spatial/tier/DistanceQueryBuilder.java | 6 ++++- .../lucene/spatial/tier/DistanceUtils.java | 6 ++++- .../spatial/tier/InvalidGeoException.java | 5 ++++ .../spatial/tier/LatLongDistanceFilter.java | 5 ++++ .../org/apache/lucene/spatial/tier/Shape.java | 4 ++- .../projections/CartesianTierPlotter.java | 4 ++- .../spatial/tier/projections/IProjector.java | 5 ++++ .../tier/projections/SinusoidalProjector.java | 5 +++- contrib/spatial/src/java/overview.html | 27 ++++++++++++++++--- 30 files changed, 149 insertions(+), 10 deletions(-) diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashDistanceFilter.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashDistanceFilter.java index 73244858123..c4e7bd56a7a 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashDistanceFilter.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashDistanceFilter.java @@ -28,6 +28,10 @@ import org.apache.lucene.spatial.tier.DistanceFilter; import org.apache.lucene.spatial.tier.DistanceUtils; +/**

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class GeoHashDistanceFilter extends DistanceFilter { diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashUtils.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashUtils.java index a0ffa7435e3..2462a47ccfc 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashUtils.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geohash/GeoHashUtils.java @@ -22,6 +22,10 @@ import java.util.Map; /** * Based on http://en.wikipedia.org/wiki/Geohash + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class GeoHashUtils { diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/CartesianPoint.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/CartesianPoint.java index ec44f91f95f..d0fd5f97379 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/CartesianPoint.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/CartesianPoint.java @@ -21,6 +21,10 @@ package org.apache.lucene.spatial.geometry; * Represents lat/lngs as fixed point numbers translated so that all * world coordinates are in the first quadrant. The same fixed point * scale as is used for FixedLatLng is employed. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class CartesianPoint { private int x; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/DistanceUnits.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/DistanceUnits.java index 454015a735c..3648ec122de 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/DistanceUnits.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/DistanceUnits.java @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.geometry; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public enum DistanceUnits { MILES, KILOMETERS; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FixedLatLng.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FixedLatLng.java index 5be90afa27e..78c814c761c 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FixedLatLng.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FixedLatLng.java @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.geometry; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class FixedLatLng extends LatLng { public static final double SCALE_FACTOR=1000000; public static final int SCALE_FACTOR_INT=1000000; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FloatLatLng.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FloatLatLng.java index 01f0801f8db..a58a130b911 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FloatLatLng.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/FloatLatLng.java @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.geometry; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class FloatLatLng extends LatLng { private double lat; private double lng; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/LatLng.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/LatLng.java index 259fa89853a..01d178413c2 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/LatLng.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/LatLng.java @@ -23,7 +23,10 @@ package org.apache.lucene.spatial.geometry; * point based coordinates. Instances are immutable. * * @see FloatLatLng - * + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public abstract class LatLng { diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/DistanceApproximation.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/DistanceApproximation.java index fc053c22d04..bc6a08551bd 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/DistanceApproximation.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/DistanceApproximation.java @@ -19,6 +19,10 @@ package org.apache.lucene.spatial.geometry.shape; /** * Imported from mq java client. No changes made. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class DistanceApproximation { diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Ellipse.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Ellipse.java index 767b3bf9a33..1485b06a881 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Ellipse.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Ellipse.java @@ -20,6 +20,10 @@ package org.apache.lucene.spatial.geometry.shape; /** * Ellipse shape. From C++ gl. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Ellipse implements Geometry2D { private Point2D center; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Geometry2D.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Geometry2D.java index 978507b1227..dcd7ed6daa6 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Geometry2D.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Geometry2D.java @@ -20,6 +20,10 @@ package org.apache.lucene.spatial.geometry.shape; /** * Common set of operations available on 2d shapes. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public interface Geometry2D { /** diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/IntersectCase.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/IntersectCase.java index ccf833ff848..0f6cca643c5 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/IntersectCase.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/IntersectCase.java @@ -17,6 +17,12 @@ package org.apache.lucene.spatial.geometry.shape; +/** + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public enum IntersectCase { WITHIN, CONTAINS, diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LLRect.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LLRect.java index ab6f2349ce9..86520316359 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LLRect.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LLRect.java @@ -24,6 +24,10 @@ import org.apache.lucene.spatial.geometry.LatLng; /** * Lat-long rect. Instances are mutable. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class LLRect { private LatLng ll, ur; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LineSegment.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LineSegment.java index e3dee2dc526..d0a439f990e 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LineSegment.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/LineSegment.java @@ -20,6 +20,10 @@ package org.apache.lucene.spatial.geometry.shape; /** * 2d line segment. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class LineSegment { public final Point2D A = new Point2D(); diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Point2D.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Point2D.java index 9b72f9f80b0..28a706ede2e 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Point2D.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Point2D.java @@ -20,6 +20,10 @@ package org.apache.lucene.spatial.geometry.shape; /** * Point class. This type is mutable. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Point2D { private double x; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Rectangle.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Rectangle.java index 6a6c2aaabad..dc000403450 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Rectangle.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Rectangle.java @@ -20,6 +20,10 @@ package org.apache.lucene.spatial.geometry.shape; /** * Rectangle shape. + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Rectangle implements Geometry2D { private Point2D ptMin, ptMax; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Vector2D.java b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Vector2D.java index 1666a3216ae..7bb72182788 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Vector2D.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/geometry/shape/Vector2D.java @@ -20,6 +20,10 @@ package org.apache.lucene.spatial.geometry.shape; /** * 2D vector + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Vector2D { private double x; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianPolyFilterBuilder.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianPolyFilterBuilder.java index f6e0b12a3e8..ce17b4a6913 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianPolyFilterBuilder.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianPolyFilterBuilder.java @@ -29,7 +29,9 @@ import org.apache.lucene.spatial.tier.projections.SinusoidalProjector; /** - * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class CartesianPolyFilterBuilder { diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianShapeFilter.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianShapeFilter.java index 5b4b18a60ea..882a5df5588 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianShapeFilter.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/CartesianShapeFilter.java @@ -28,6 +28,11 @@ import org.apache.lucene.search.DocIdSet; import org.apache.lucene.util.NumericUtils; import org.apache.lucene.util.OpenBitSet; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class CartesianShapeFilter extends Filter { /** diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFieldComparatorSource.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFieldComparatorSource.java index 83568f1a1ac..af20f9f07ef 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFieldComparatorSource.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFieldComparatorSource.java @@ -24,6 +24,11 @@ import org.apache.lucene.search.Filter; import org.apache.lucene.search.FieldComparator; import org.apache.lucene.search.FieldComparatorSource; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class DistanceFieldComparatorSource extends FieldComparatorSource { private static final long serialVersionUID = 1L; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFilter.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFilter.java index b83bef101d5..412752717d2 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFilter.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceFilter.java @@ -23,6 +23,11 @@ import java.util.HashMap; import org.apache.lucene.search.Filter; import org.apache.lucene.spatial.tier.DistanceHandler.Precision; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public abstract class DistanceFilter extends Filter { final protected Filter startingFilter; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceHandler.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceHandler.java index ee7b1640c81..d78dddf4b16 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceHandler.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceHandler.java @@ -24,6 +24,9 @@ import java.util.Map; * Provide a high level access point to distances * Used by DistanceSortSource and DistanceQuery * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. * */ public class DistanceHandler { diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceQueryBuilder.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceQueryBuilder.java index c27cd10e8ed..08b1b45e0bb 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceQueryBuilder.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceQueryBuilder.java @@ -24,7 +24,11 @@ import org.apache.lucene.search.QueryWrapperFilter; import org.apache.lucene.spatial.geohash.GeoHashDistanceFilter; import org.apache.lucene.misc.ChainedFilter; - +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class DistanceQueryBuilder { private static final long serialVersionUID = 1L; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceUtils.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceUtils.java index 60764ed9510..f5414631c48 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceUtils.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/DistanceUtils.java @@ -23,7 +23,11 @@ import org.apache.lucene.spatial.geometry.LatLng; import org.apache.lucene.spatial.geometry.shape.LLRect; import org.apache.lucene.spatial.geometry.shape.Rectangle; - +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class DistanceUtils { static DistanceUtils instance = new DistanceUtils(); diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/InvalidGeoException.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/InvalidGeoException.java index 4920f0dc304..1338b94cae3 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/InvalidGeoException.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/InvalidGeoException.java @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.tier; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class InvalidGeoException extends Exception { /** diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/LatLongDistanceFilter.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/LatLongDistanceFilter.java index bdf6183c38e..e37db4dd023 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/LatLongDistanceFilter.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/LatLongDistanceFilter.java @@ -25,6 +25,11 @@ import org.apache.lucene.search.Filter; import org.apache.lucene.search.DocIdSet; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public class LatLongDistanceFilter extends DistanceFilter { /** diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/Shape.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/Shape.java index 9c0a55c64fe..5b95b3f8421 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/Shape.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/Shape.java @@ -21,7 +21,9 @@ import java.util.ArrayList; import java.util.List; /** - * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class Shape { diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/CartesianTierPlotter.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/CartesianTierPlotter.java index bcd82b4c79b..837a24a2208 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/CartesianTierPlotter.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/CartesianTierPlotter.java @@ -18,7 +18,9 @@ package org.apache.lucene.spatial.tier.projections; /** - * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class CartesianTierPlotter { public static final String DEFALT_FIELD_PREFIX = "_tier_"; diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/IProjector.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/IProjector.java index 35b7c2fc5ae..88c6f079849 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/IProjector.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/IProjector.java @@ -17,6 +17,11 @@ package org.apache.lucene.spatial.tier.projections; +/** + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. + */ public interface IProjector { public String coordsAsString(double latitude, double longitude); public double[] coords(double latitude, double longitude); diff --git a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/SinusoidalProjector.java b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/SinusoidalProjector.java index 29a41c52338..7be1f375c27 100644 --- a/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/SinusoidalProjector.java +++ b/contrib/spatial/src/java/org/apache/lucene/spatial/tier/projections/SinusoidalProjector.java @@ -20,7 +20,10 @@ package org.apache.lucene.spatial.tier.projections; /** * Based on Sinusoidal Projections * Project a latitude / longitude on a 2D cartisian map - * + * + *

NOTE: This API is still in + * flux and might change in incompatible ways in the next + * release. */ public class SinusoidalProjector implements IProjector { diff --git a/contrib/spatial/src/java/overview.html b/contrib/spatial/src/java/overview.html index 1ed83f0cf51..39109339419 100644 --- a/contrib/spatial/src/java/overview.html +++ b/contrib/spatial/src/java/overview.html @@ -17,10 +17,31 @@ - spatial + Geographical filtering & sorting with Lucene - spatial + +

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. + - \ No newline at end of file + +