Package org.apache.solr.legacy

Class BBoxStrategy

java.lang.Object

org.apache.lucene.spatial.SpatialStrategy

org.apache.solr.legacy.BBoxStrategy

@Deprecated
public class BBoxStrategy
extends org.apache.lucene.spatial.SpatialStrategy

Deprecated.

A SpatialStrategy for indexing and searching Rectangles by storing its coordinates in numeric fields. It supports all SpatialOperations and has a custom overlap relevancy. It is based on GeoPortal's SpatialClauseAdapter.

Characteristics:

• Only indexes Rectangles; just one per field value. Other shapes can be provided and the bounding box will be used.
• Can query only by a Rectangle. Providing other shapes is an error.
• Supports most SpatialOperations but not Overlaps.
• Uses the DocValues API for any sorting / relevancy.

Implementation:

This uses 4 double fields for minX, maxX, minY, maxY and a boolean to mark a dateline cross. Depending on the particular SpatialOperations, there are a variety of range queries on DoublePoints to be done. The makeOverlapRatioValueSource(org.locationtech.spatial4j.shape.Rectangle, double) works by calculating the query bbox overlap percentage against the indexed shape overlap percentage. The indexed shape's coordinates are retrieved from LeafReader.getNumericDocValues(java.lang.String).

WARNING: This API is experimental and might change in incompatible ways in the next release.

Field Summary

Fields

Modifier and Type	Field	Description
static org.apache.lucene.document.FieldType	DEFAULT_FIELDTYPE	Deprecated. pointValues, docValues, and nothing else.
static LegacyFieldType	LEGACY_FIELDTYPE	Deprecated.
static String	SUFFIX_MAXX	Deprecated.
static String	SUFFIX_MAXY	Deprecated.
static String	SUFFIX_MINX	Deprecated.
static String	SUFFIX_MINY	Deprecated.
static String	SUFFIX_XDL	Deprecated.

Fields inherited from class org.apache.lucene.spatial.SpatialStrategy

ctx

Constructor Summary

Constructors

Constructor	Description
BBoxStrategy(org.locationtech.spatial4j.context.SpatialContext ctx, String fieldNamePrefix, org.apache.lucene.document.FieldType fieldType)	Deprecated. Creates this strategy.

Method Summary

Modifier and Type	Method	Description
org.apache.lucene.document.Field[]	createIndexableFields(org.locationtech.spatial4j.shape.Shape shape)	Deprecated.
org.apache.lucene.document.FieldType	getFieldType()	Deprecated. Returns a field type representing the set of field options.
org.apache.lucene.search.DoubleValuesSource	makeDistanceValueSource(org.locationtech.spatial4j.shape.Point queryPoint, double multiplier)	Deprecated.
org.apache.lucene.search.DoubleValuesSource	makeOverlapRatioValueSource(org.locationtech.spatial4j.shape.Rectangle queryBox, double queryTargetProportion)	Deprecated. Returns a similarity based on BBoxOverlapRatioValueSource.
org.apache.lucene.search.Query	makeQuery(org.apache.lucene.spatial.query.SpatialArgs args)	Deprecated.
org.apache.lucene.spatial.ShapeValuesSource	makeShapeValueSource()	Deprecated. Provides access to each rectangle per document
static BBoxStrategy	newInstance(org.locationtech.spatial4j.context.SpatialContext ctx, String fieldNamePrefix)	Deprecated. Creates a new BBoxStrategy instance that uses DoublePoint and DoublePoint.newRangeQuery(java.lang.String, double, double)
static BBoxStrategy	newLegacyInstance(org.locationtech.spatial4j.context.SpatialContext ctx, String fieldNamePrefix)	Deprecated. LegacyNumerics will be removed

Methods inherited from class org.apache.lucene.spatial.SpatialStrategy

getFieldName, getSpatialContext, makeDistanceValueSource, makeRecipDistanceValueSource, toString

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_FIELDTYPE

public static org.apache.lucene.document.FieldType DEFAULT_FIELDTYPE

Deprecated.

pointValues, docValues, and nothing else.

LEGACY_FIELDTYPE

@Deprecated
public static LegacyFieldType LEGACY_FIELDTYPE

Deprecated.

SUFFIX_MINX

public static final String SUFFIX_MINX

Deprecated.

See Also:

Constant Field Values

SUFFIX_MAXX

public static final String SUFFIX_MAXX

Deprecated.

See Also:

Constant Field Values

SUFFIX_MINY

public static final String SUFFIX_MINY

Deprecated.

See Also:

Constant Field Values

SUFFIX_MAXY

public static final String SUFFIX_MAXY

Deprecated.

See Also:

Constant Field Values

SUFFIX_XDL

public static final String SUFFIX_XDL

Deprecated.

See Also:

Constant Field Values

Constructor Detail

BBoxStrategy

public BBoxStrategy(org.locationtech.spatial4j.context.SpatialContext ctx,
                    String fieldNamePrefix,
                    org.apache.lucene.document.FieldType fieldType)

Deprecated.

Creates this strategy. fieldType is used to customize the indexing options of the 4 number fields, and to a lesser degree the XDL field too. Search requires pointValues (or legacy numerics), and relevancy requires docValues. If these features aren't needed then disable them.

Method Detail

newInstance

public static BBoxStrategy newInstance(org.locationtech.spatial4j.context.SpatialContext ctx,
                                       String fieldNamePrefix)

Deprecated.

Creates a new BBoxStrategy instance that uses DoublePoint and DoublePoint.newRangeQuery(java.lang.String, double, double)

newLegacyInstance

@Deprecated
public static BBoxStrategy newLegacyInstance(org.locationtech.spatial4j.context.SpatialContext ctx,
                                             String fieldNamePrefix)

Deprecated.

LegacyNumerics will be removed

Creates a new BBoxStrategy instance that uses LegacyDoubleField for backwards compatibility

getFieldType

public org.apache.lucene.document.FieldType getFieldType()

Deprecated.

Returns a field type representing the set of field options. This is identical to what was passed into the constructor. It's frozen.

createIndexableFields

public org.apache.lucene.document.Field[] createIndexableFields(org.locationtech.spatial4j.shape.Shape shape)

Deprecated.

Specified by:

createIndexableFields in class org.apache.lucene.spatial.SpatialStrategy

makeShapeValueSource

public org.apache.lucene.spatial.ShapeValuesSource makeShapeValueSource()

Deprecated.

Provides access to each rectangle per document

makeDistanceValueSource

public org.apache.lucene.search.DoubleValuesSource makeDistanceValueSource(org.locationtech.spatial4j.shape.Point queryPoint,
                                                                           double multiplier)

Deprecated.

Specified by:

makeDistanceValueSource in class org.apache.lucene.spatial.SpatialStrategy

makeOverlapRatioValueSource

public org.apache.lucene.search.DoubleValuesSource makeOverlapRatioValueSource(org.locationtech.spatial4j.shape.Rectangle queryBox,
                                                                               double queryTargetProportion)

Deprecated.

Returns a similarity based on BBoxOverlapRatioValueSource. This is just a convenience method.

makeQuery

public org.apache.lucene.search.Query makeQuery(org.apache.lucene.spatial.query.SpatialArgs args)

Deprecated.

Specified by:

makeQuery in class org.apache.lucene.spatial.SpatialStrategy