org.elasticsearch.search.sort

Class GeoDistanceSortBuilder

java.lang.Object

org.elasticsearch.action.support.ToXContentToBytes

org.elasticsearch.search.sort.SortBuilder<GeoDistanceSortBuilder>

org.elasticsearch.search.sort.GeoDistanceSortBuilder

All Implemented Interfaces:

NamedWriteable, Writeable, ToXContent

public class GeoDistanceSortBuilder
extends SortBuilder<GeoDistanceSortBuilder>

A geo distance based sorting on a geo point like field.

Nested Class Summary

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Nested classes/interfaces inherited from interface org.elasticsearch.common.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ALTERNATIVE_NAME
static GeoValidationMethod	DEFAULT_VALIDATION
static java.lang.String	NAME

Fields inherited from class org.elasticsearch.search.sort.SortBuilder

NESTED_FILTER_FIELD, NESTED_PATH_FIELD, order, ORDER_FIELD

Fields inherited from interface org.elasticsearch.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor and Description
GeoDistanceSortBuilder(StreamInput in) Read from a stream.
GeoDistanceSortBuilder(java.lang.String fieldName, double lat, double lon) Constructs a new distance based sort on a geo point like field.
GeoDistanceSortBuilder(java.lang.String fieldName, GeoPoint... points) Constructs a new distance based sort on a geo point like field.
GeoDistanceSortBuilder(java.lang.String fieldName, java.lang.String... geohashes) Constructs a new distance based sort on a geo point like field.

Method Summary

Modifier and Type	Method and Description
SortFieldAndFormat	build(QueryShardContext context) Create a @link SortFieldAndFormat from this builder.
boolean	equals(java.lang.Object object)
java.lang.String	fieldName() Returns the geo point like field the distance based sort operates on.
static GeoDistanceSortBuilder	fromXContent(QueryParseContext context, java.lang.String elementName) Creates a new GeoDistanceSortBuilder from the query held by the QueryParseContext in XContent format.
GeoDistance	geoDistance() Returns the geo distance type used to compute the distance.
GeoDistanceSortBuilder	geoDistance(GeoDistance geoDistance) The geo distance type used to compute the distance.
GeoDistanceSortBuilder	geohashes(java.lang.String... geohashes) Deprecated.
QueryBuilder	getNestedFilter() Returns the nested filter that the nested objects should match with in order to be taken into account for sorting.
java.lang.String	getNestedPath() Returns the nested path if sorting occurs on a field that is inside a nested object.
java.lang.String	getWriteableName() Returns the name of the writeable object
int	hashCode()
GeoDistanceSortBuilder	point(double lat, double lon) The point to create the range distance facets from.
GeoPoint[]	points() Returns the points to create the range distance facets from.
GeoDistanceSortBuilder	points(GeoPoint... points) The point to create the range distance facets from.
GeoDistanceSortBuilder	setNestedFilter(QueryBuilder nestedFilter) Sets the nested filter that the nested objects should match with in order to be taken into account for sorting.
GeoDistanceSortBuilder	setNestedPath(java.lang.String nestedPath) Sets the nested path if sorting occurs on a field that is inside a nested object.
SortMode	sortMode() Returns which distance to use for sorting in the case a document contains multiple geo points.
GeoDistanceSortBuilder	sortMode(SortMode sortMode) Defines which distance to use for sorting in the case a document contains multiple geo points.
XContentBuilder	toXContent(XContentBuilder builder, ToXContent.Params params)
DistanceUnit	unit() Returns the distance unit to use.
GeoDistanceSortBuilder	unit(DistanceUnit unit) The distance unit to use.
GeoValidationMethod	validation() Returns the validation method to use for this sort builder.
GeoDistanceSortBuilder	validation(GeoValidationMethod method) Sets validation method for this sort builder.
void	writeTo(StreamOutput out) Write this into the StreamOutput.

Methods inherited from class org.elasticsearch.search.sort.SortBuilder

buildSort, fromXContent, order, order, parseNestedFilter, resolveNested

Methods inherited from class org.elasticsearch.action.support.ToXContentToBytes

buildAsBytes, buildAsBytes, toString, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.elasticsearch.common.xcontent.ToXContent

isFragment

Field Detail

NAME

public static final java.lang.String NAME

See Also:

Constant Field Values

ALTERNATIVE_NAME

public static final java.lang.String ALTERNATIVE_NAME

See Also:

Constant Field Values

DEFAULT_VALIDATION

public static final GeoValidationMethod DEFAULT_VALIDATION

Constructor Detail

GeoDistanceSortBuilder

public GeoDistanceSortBuilder(java.lang.String fieldName,
                              GeoPoint... points)

Constructs a new distance based sort on a geo point like field.

Parameters:

fieldName - The geo point like field name.

points - The points to create the range distance facets from.

GeoDistanceSortBuilder

public GeoDistanceSortBuilder(java.lang.String fieldName,
                              double lat,
                              double lon)

Constructs a new distance based sort on a geo point like field.

Parameters:

fieldName - The geo point like field name.

lat - Latitude of the point to create the range distance facets from.

lon - Longitude of the point to create the range distance facets from.

GeoDistanceSortBuilder

public GeoDistanceSortBuilder(java.lang.String fieldName,
                              java.lang.String... geohashes)

Constructs a new distance based sort on a geo point like field.

Parameters:

fieldName - The geo point like field name.

geohashes - The points to create the range distance facets from.

GeoDistanceSortBuilder

public GeoDistanceSortBuilder(StreamInput in)
                       throws java.io.IOException

Read from a stream.

Throws:

java.io.IOException

Method Detail

writeTo

public void writeTo(StreamOutput out)
             throws java.io.IOException

Description copied from interface: Writeable

Write this into the StreamOutput.

Throws:

java.io.IOException

fieldName

public java.lang.String fieldName()

Returns the geo point like field the distance based sort operates on.

point

public GeoDistanceSortBuilder point(double lat,
                                    double lon)

The point to create the range distance facets from.

Parameters:

lat - latitude.

lon - longitude.

points

public GeoDistanceSortBuilder points(GeoPoint... points)

The point to create the range distance facets from.

Parameters:

points - reference points.

points

public GeoPoint[] points()

Returns the points to create the range distance facets from.

geohashes

@Deprecated
public GeoDistanceSortBuilder geohashes(java.lang.String... geohashes)

Deprecated.

The geohash of the geo point to create the range distance facets from. Deprecated - please use points(GeoPoint... points) instead.

geoDistance

public GeoDistanceSortBuilder geoDistance(GeoDistance geoDistance)

The geo distance type used to compute the distance.

geoDistance

public GeoDistance geoDistance()

Returns the geo distance type used to compute the distance.

unit

public GeoDistanceSortBuilder unit(DistanceUnit unit)

The distance unit to use. Defaults to DistanceUnit.METERS

unit

public DistanceUnit unit()

Returns the distance unit to use. Defaults to DistanceUnit.METERS

validation

public GeoDistanceSortBuilder validation(GeoValidationMethod method)

Sets validation method for this sort builder.

validation

public GeoValidationMethod validation()

Returns the validation method to use for this sort builder.

sortMode

public GeoDistanceSortBuilder sortMode(SortMode sortMode)

Defines which distance to use for sorting in the case a document contains multiple geo points. Possible values: min and max

sortMode

public SortMode sortMode()

Returns which distance to use for sorting in the case a document contains multiple geo points.

setNestedFilter

public GeoDistanceSortBuilder setNestedFilter(QueryBuilder nestedFilter)

Sets the nested filter that the nested objects should match with in order to be taken into account for sorting.

getNestedFilter

public QueryBuilder getNestedFilter()

Returns the nested filter that the nested objects should match with in order to be taken into account for sorting.

setNestedPath

public GeoDistanceSortBuilder setNestedPath(java.lang.String nestedPath)

Sets the nested path if sorting occurs on a field that is inside a nested object. By default when sorting on a field inside a nested object, the nearest upper nested object is selected as nested path.

getNestedPath

public java.lang.String getNestedPath()

Returns the nested path if sorting occurs on a field that is inside a nested object. By default when sorting on a field inside a nested object, the nearest upper nested object is selected as nested path.

toXContent

public XContentBuilder toXContent(XContentBuilder builder,
                                  ToXContent.Params params)
                           throws java.io.IOException

Throws:

java.io.IOException

getWriteableName

public java.lang.String getWriteableName()

Description copied from interface: NamedWriteable

Returns the name of the writeable object

equals

public boolean equals(java.lang.Object object)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

fromXContent

public static GeoDistanceSortBuilder fromXContent(QueryParseContext context,
                                                  java.lang.String elementName)
                                           throws java.io.IOException

Creates a new GeoDistanceSortBuilder from the query held by the QueryParseContext in XContent format.

Parameters:

context - the input parse context. The state on the parser contained in this context will be changed as a side effect of this method call

elementName - in some sort syntax variations the field name precedes the xContent object that specifies further parameters, e.g. in '{ "foo": { "order" : "asc"} }'. When parsing the inner object, the field name can be passed in via this argument

Throws:

java.io.IOException

build

public SortFieldAndFormat build(QueryShardContext context)
                         throws java.io.IOException

Description copied from class: SortBuilder

Create a @link SortFieldAndFormat from this builder.

Specified by:

build in class SortBuilder<GeoDistanceSortBuilder>

Throws:

java.io.IOException