org.springframework.data.mongodb.core.aggregation

Class GeoNearOperation

java.lang.Object

org.springframework.data.mongodb.core.aggregation.GeoNearOperation

All Implemented Interfaces:

AggregationOperation

public class GeoNearOperation
extends Object
implements AggregationOperation

Represents a geoNear aggregation operation.

We recommend to use the static factory method Aggregation.geoNear(NearQuery, String) instead of creating instances of this class directly.

Since:

1.3

Author:

Thomas Darimont, Christoph Strobl

See Also:

MongoDB Aggregation Framework: $geoNear

Constructor Summary

Constructors

Constructor and Description
GeoNearOperation(NearQuery nearQuery, String distanceField) Creates a new GeoNearOperation from the given NearQuery and the given distance field.

Method Summary

Modifier and Type	Method and Description
org.bson.Document	toDocument(AggregationOperationContext context) Turns the AggregationOperation into a Document by using the given AggregationOperationContext.
GeoNearOperation	useIndex(String key) Optionally specify the geospatial index to use via the field to use in the calculation.

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoNearOperation

public GeoNearOperation(NearQuery nearQuery,
                        String distanceField)

Creates a new GeoNearOperation from the given NearQuery and the given distance field. The distanceField defines output field that contains the calculated distance.

Parameters:

nearQuery - must not be null.

distanceField - must not be null.

Method Detail

useIndex

public GeoNearOperation useIndex(String key)

Optionally specify the geospatial index to use via the field to use in the calculation.
NOTE: Requires MongoDB 4.0 or later.

Parameters:

key - the geospatial index field to use when calculating the distance.

Returns:

new instance of GeoNearOperation.

Since:

2.1

toDocument

public org.bson.Document toDocument(AggregationOperationContext context)

Description copied from interface: AggregationOperation

Turns the AggregationOperation into a Document by using the given AggregationOperationContext.

Specified by:

toDocument in interface AggregationOperation

Returns:

the Document