lumis.portal.bigdata.query

Class GeoDistanceAggregation

java.lang.Object

lumis.portal.bigdata.query.GeoDistanceAggregation

All Implemented Interfaces:

IAggregation, IFieldAwareAggregation, ISubAggregationAwareAggregation

@StableMinor(version="10.1",
             sinceVersion="9.0")
public class GeoDistanceAggregation
extends Object
implements IFieldAwareAggregation

Aggregation that aggregates the documents based on a center point and a collection of ranges.
This aggregation produces a result of type IGeoDistanceAggregationResult. Each range will generate a bucket to store documents that that have a distance that fit into the given range.

The given field will be used to calculate the geo distance to the given center point. Thus, the given field must be of the data type DocumentTypeField.DataType.GEO_POINT.

If the given field is a list, the closest point to the center will be considered.

It is important to notice that at least one range must be added.

Since:

9.0.0

Version:

$Revision: 19961 $ $Date: 2017-02-21 21:39:20 +0000 (Tue, 21 Feb 2017) $

See Also:

Distance, Range, IMultiBucketAggregationResult, IGeoDistanceAggregationResult, GeoPoint, SearchQuery.addAggregation(IAggregation)

Constructor Summary

Constructors

Constructor and Description
GeoDistanceAggregation(String id, DocumentTypeField field, GeoPoint pin) Creates a new instance of the aggregation.

Method Summary

Modifier and Type	Method and Description
GeoDistanceAggregation	addRanges(Collection<Range<Double>> ranges) Add the given ranges to the aggregation.
GeoDistanceAggregation	addRanges(Range<Double>... ranges) Add the given ranges to the aggregation.
void	addSubAggregation(IAggregation aggregation) Adds the given sub-aggregation.
void	addSubAggregations(IAggregation... aggregations) Adds the given sub-aggregations.
void	addSubAggregations(List<IAggregation> aggregations) Adds the given sub-aggregations.
DocumentTypeField	getField() Returns the field this aggregation is bound to.
String	getId() Returns the aggregation identifier.
GeoPoint	getPin() Returns the center point of the aggregation.
List<Range<Double>>	getRanges() Returns the range list.
List<IAggregation>	getSubAggregations() Returns an unmodifiable list of the sub-aggregations.

Methods inherited from class java.lang.Object

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

Methods inherited from interface lumis.portal.bigdata.query.IAggregation

getId

Constructor Detail

GeoDistanceAggregation

public GeoDistanceAggregation(String id,
                              DocumentTypeField field,
                              GeoPoint pin)

Creates a new instance of the aggregation.

Parameters:

id - the aggregation identifier.

field - the field to be used to calculate the distance to the center point.

pin - the center point from which the distance will be calculated.

Since:

9.0.0

Method Detail

addRanges

public GeoDistanceAggregation addRanges(Range<Double>... ranges)

Add the given ranges to the aggregation.

Parameters:

ranges - the ranges.

Returns:

the aggregation.

Since:

9.0.0

addRanges

public GeoDistanceAggregation addRanges(Collection<Range<Double>> ranges)

Add the given ranges to the aggregation.

Parameters:

ranges - the ranges.

Returns:

the aggregation.

Since:

9.0.0

getRanges

public List<Range<Double>> getRanges()

Returns the range list.

Returns:

the range list.

Since:

9.0.0

getField

public DocumentTypeField getField()

Description copied from interface: IFieldAwareAggregation

Returns the field this aggregation is bound to.

Specified by:

getField in interface IFieldAwareAggregation

Returns:

the field this aggregation is bound to.

getPin

public GeoPoint getPin()

Returns the center point of the aggregation.

Returns:

the center point of the aggregation.

Since:

9.0.0

getId

public String getId()

Description copied from interface: IAggregation

Returns the aggregation identifier.

Specified by:

getId in interface IAggregation

Returns:

the aggregation identifier.

addSubAggregation

public void addSubAggregation(IAggregation aggregation)

Description copied from interface: ISubAggregationAwareAggregation

Adds the given sub-aggregation.

Specified by:

addSubAggregation in interface ISubAggregationAwareAggregation

getSubAggregations

public List<IAggregation> getSubAggregations()

Description copied from interface: ISubAggregationAwareAggregation

Returns an unmodifiable list of the sub-aggregations.

Specified by:

getSubAggregations in interface ISubAggregationAwareAggregation

Returns:

an unmodifiable list of the sub-aggregations.

addSubAggregations

public void addSubAggregations(IAggregation... aggregations)

Description copied from interface: ISubAggregationAwareAggregation

Adds the given sub-aggregations.

Specified by:

addSubAggregations in interface ISubAggregationAwareAggregation

Parameters:

aggregations - the sub-aggregations.

addSubAggregations

public void addSubAggregations(List<IAggregation> aggregations)

Description copied from interface: ISubAggregationAwareAggregation

Adds the given sub-aggregations.

Specified by:

addSubAggregations in interface ISubAggregationAwareAggregation

Parameters:

aggregations - the sub-aggregations.