org.mongodb.morphia.aggregation

Class GeoNear.GeoNearBuilder

java.lang.Object

org.mongodb.morphia.aggregation.GeoNear.GeoNearBuilder

Enclosing class:

GeoNear

public static class GeoNear.GeoNearBuilder
extends Object

Constructor Summary

Constructors

Constructor and Description
GeoNear.GeoNearBuilder(String distanceField)

Method Summary

Methods

Modifier and Type	Method and Description
GeoNear	build()
GeoNear.GeoNearBuilder	setDistanceMultiplier(Double distanceMultiplier) The factor to multiply all distances returned by the query.
GeoNear.GeoNearBuilder	setIncludeLocations(String includeLocations) This specifies the output field that identifies the location used to calculate the distance.
GeoNear.GeoNearBuilder	setLimit(Long limit) The maximum number of documents to return.
GeoNear.GeoNearBuilder	setMaxDistance(Double maxDistance) A distance from the center point.
GeoNear.GeoNearBuilder	setMaxDocuments(Long num) The maxDocuments option provides the same function as the limit option.
GeoNear.GeoNearBuilder	setNear(double latitude, double longitude)
GeoNear.GeoNearBuilder	setQuery(Query query) Limits the results to the documents that match the query.
GeoNear.GeoNearBuilder	setSpherical(Boolean spherical) If true, MongoDB references points using a spherical surface.
GeoNear.GeoNearBuilder	setUniqueDocuments(Boolean uniqueDocuments) Deprecated. Deprecated since server version 2.6: Geospatial queries no longer return duplicate results. The $uniqueDocs operator has no impact on results.

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoNear.GeoNearBuilder

public GeoNear.GeoNearBuilder(String distanceField)

Parameters:

distanceField - The output field that contains the calculated distance. To specify a field within a subdocument, use dot notation.

See Also:

dot notation

Method Detail

setNear

public GeoNear.GeoNearBuilder setNear(double latitude,
                             double longitude)

setLimit

public GeoNear.GeoNearBuilder setLimit(Long limit)

The maximum number of documents to return. The default value is 100.

See Also:

setMaxDocuments(Long).

setMaxDocuments

public GeoNear.GeoNearBuilder setMaxDocuments(Long num)

The maxDocuments option provides the same function as the limit option. Both define the maximum number of documents to return. If both options are included, this value overrides the limit value.

setMaxDistance

public GeoNear.GeoNearBuilder setMaxDistance(Double maxDistance)

A distance from the center point. Specify the distance in radians. MongoDB limits the results to those documents that fall within the specified distance from the center point.

setQuery

public GeoNear.GeoNearBuilder setQuery(Query query)

Limits the results to the documents that match the query. The query syntax is the usual MongoDB read operation query syntax.

See Also:

MongoDB read operation query syntax

setSpherical

public GeoNear.GeoNearBuilder setSpherical(Boolean spherical)

If true, MongoDB references points using a spherical surface. The default value is false.

setDistanceMultiplier

public GeoNear.GeoNearBuilder setDistanceMultiplier(Double distanceMultiplier)

The factor to multiply all distances returned by the query. For example, use the distanceMultiplier to convert radians, as returned by a spherical query, to kilometers by multiplying by the radius of the Earth.

setIncludeLocations

public GeoNear.GeoNearBuilder setIncludeLocations(String includeLocations)

This specifies the output field that identifies the location used to calculate the distance. This option is useful when a location field contains multiple locations. To specify a field within a subdocument, use dot notation.

See Also:

dot notation

setUniqueDocuments

@Deprecated
public GeoNear.GeoNearBuilder setUniqueDocuments(Boolean uniqueDocuments)

Deprecated. Deprecated since server version 2.6: Geospatial queries no longer return duplicate results. The $uniqueDocs operator has no impact on results.

If this value is true, the query returns a matching document once, even if more than one of the document's location fields match the query. If this value is false, the query returns a document multiple times if the document has multiple matching location fields. See $uniqueDocs for more information.

Parameters:

uniqueDocuments - true if only unique documents are required in the return value

Returns:

this builder

See Also:

uniqueDocs

build

public GeoNear build()