org.hibernate.search.spatial.impl

Class SpatialQueryBuilderFromCoordinates

java.lang.Object

org.hibernate.search.spatial.impl.SpatialQueryBuilderFromCoordinates

public abstract class SpatialQueryBuilderFromCoordinates
extends Object

The SpatialQueryBuilder holds builder methods for Hash, Distance and Spatial (Hash+Distance) filters and queries

Author:

Nicolas Helleringer

Constructor Summary

Constructors

Constructor and Description
SpatialQueryBuilderFromCoordinates()

Method Summary

Modifier and Type	Method and Description
static Filter	buildDistanceFilter(Filter previousFilter, Coordinates center, double radius, String coordinatesField) Returns a Lucene filter to fine filter document by distance
static Filter	buildDistanceFilter(Filter previousFilter, Coordinates center, double radius, String latitudeField, String longitudeField) Returns a Lucene filter to fine filter document by distance
static Query	buildDistanceQuery(Coordinates center, double radius, String fieldName) Returns a Lucene Query searching directly by computing distance against all docs in the index (costly !)
static Filter	buildSpatialHashFilter(Coordinates center, double radius, String fieldName) Returns a Lucene filter which rely on Hibernate Search Spatial spatial hash indexation to filter document at radius
static Query	buildSpatialHashQuery(Coordinates center, double radius, String fieldName) Returns a Lucene Query which rely on Hibernate Search Spatial spatial hash indexation to filter document at radius by wrapping a SpatialHashFilter
static Query	buildSpatialQueryByHash(Coordinates center, double radius, String fieldName) Returns a Lucene Query which relies on Hibernate Search Spatial spatial hash indexation to filter documents at radius and filter its results by a fine DistanceFilter
static Query	buildSpatialQueryByRange(Coordinates centerCoordinates, double radius, String fieldName) Returns a Lucene Query which rely on double numeric range query on Latitude / Longitude

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SpatialQueryBuilderFromCoordinates

public SpatialQueryBuilderFromCoordinates()

Method Detail

buildSpatialHashFilter

public static Filter buildSpatialHashFilter(Coordinates center,
                                            double radius,
                                            String fieldName)

Returns a Lucene filter which rely on Hibernate Search Spatial spatial hash indexation to filter document at radius

Parameters:

center - center of the search discus

radius - distance max to center in km

fieldName - name of the Lucene Field implementing Coordinates

Returns:

Lucene filter to be used in a Query

See Also:

Query, Coordinates, Filter

buildDistanceFilter

public static Filter buildDistanceFilter(Filter previousFilter,
                                         Coordinates center,
                                         double radius,
                                         String coordinatesField)

Returns a Lucene filter to fine filter document by distance

Parameters:

center - center of the search discus

radius - distance max to center in km

coordinatesField - name of the Lucene Field implementing Coordinates

previousFilter - preceding filter in filter chain Warning if passed null DistanceFilter constructor use a filter wrapped match all query (time/resource consuming !)

Returns:

Lucene filter to be used in a Query

See Also:

Query, Coordinates, DistanceFilter, Filter

buildDistanceFilter

public static Filter buildDistanceFilter(Filter previousFilter,
                                         Coordinates center,
                                         double radius,
                                         String latitudeField,
                                         String longitudeField)

Returns a Lucene filter to fine filter document by distance

Parameters:

center - center of the search discus

radius - distance max to center in km

latitudeField - name of the Lucene Field hosting latitude

longitudeField - name of the Lucene Field hosting longitude

previousFilter - preceding filter in filter chain Warning if passed null DistanceFilter constructor use a filter wrapped match all query (time/ressource consuming !)

Returns:

Lucene filter to be used in a Query

See Also:

Query, Coordinates, DistanceFilter, Filter

buildSpatialHashQuery

public static Query buildSpatialHashQuery(Coordinates center,
                                          double radius,
                                          String fieldName)

Returns a Lucene Query which rely on Hibernate Search Spatial spatial hash indexation to filter document at radius by wrapping a SpatialHashFilter

Parameters:

center - center of the search discus

radius - distance max to center in km

fieldName - name of the Lucene Field implementing Coordinates

Returns:

Lucene Query to be used in a search

See Also:

Query, Coordinates

buildDistanceQuery

public static Query buildDistanceQuery(Coordinates center,
                                       double radius,
                                       String fieldName)

Returns a Lucene Query searching directly by computing distance against all docs in the index (costly !)

Parameters:

center - center of the search discus

radius - distance max to center in km

fieldName - name of the Lucene Field implementing Coordinates

Returns:

Lucene Query to be used in a search

See Also:

Query, Coordinates

buildSpatialQueryByHash

public static Query buildSpatialQueryByHash(Coordinates center,
                                            double radius,
                                            String fieldName)

Returns a Lucene Query which relies on Hibernate Search Spatial spatial hash indexation to filter documents at radius and filter its results by a fine DistanceFilter

Parameters:

center - center of the search discus

radius - distance max to center in km

fieldName - name of the Lucene Field implementing Coordinates

Returns:

Lucene Query to be used in a search

See Also:

Query, Coordinates

buildSpatialQueryByRange

public static Query buildSpatialQueryByRange(Coordinates centerCoordinates,
                                             double radius,
                                             String fieldName)

Returns a Lucene Query which rely on double numeric range query on Latitude / Longitude

Parameters:

centerCoordinates - center of the search discus

radius - distance max to center in km

fieldName - name of the Lucene Field implementing Coordinates

Returns:

Lucene Query to be used in a search

See Also:

Query, Coordinates