To support geospatial queries, MongoDB provides various geospatial indexes as well as geospatial query operators.


  • The example below requires a restaurants collection in the test database. To create and populate the collection, follow the directions in github.

  • Include the following import statements:

import com.mongodb.Block;
import com.mongodb.async.SingleResultCallback;
import com.mongodb.async.client.MongoClient;
import com.mongodb.async.client.MongoClients;
import com.mongodb.async.client.MongoCollection;
import com.mongodb.async.client.MongoDatabase;
import com.mongodb.client.model.Filters;
import com.mongodb.client.model.Indexes;
import com.mongodb.client.model.geojson.Point;
import com.mongodb.client.model.geojson.Position;
import org.bson.Document;
  • Include the following callback code which the examples in the tutorials will use:
SingleResultCallback<Void> callbackWhenFinished = new SingleResultCallback<Void>() {
    public void onResult(final Void result, final Throwable t) {
        System.out.println("Operation Finished!");
  • Include the following code which the examples in the tutorials will use to print the results of the aggregation:
Block<Document> printBlock = new Block<Document>() {
    public void apply(final Document document) {

Connect to a MongoDB Deployment

Connect to a MongoDB deployment and declare and define a MongoDatabase and a MongoCollection instances.

For example, include the following code to connect to a standalone MongoDB deployment running on localhost on port 27017 and define database to refer to the test database and collection to refer to the restaurants collection:

MongoClient mongoClient = MongoClients.create();
MongoDatabase database = mongoClient.getDatabase("test");
MongoCollection<Document> collection = database.getCollection("restaurants");

For additional information on connecting to MongoDB, see Connect to MongoDB.

Create the 2dsphere Index

To create a 2dsphere index, use the Indexes.geo2dsphere helper to create a specification for the 2dsphere index and pass to MongoCollection.createIndex() method.

The following example creates a 2dsphere index on the "contact.location" field for the restaurants collection.

collection.createIndex(Indexes.geo2dsphere("contact.location"), new SingleResultCallback<String>() {
    public void onResult(final String result, final Throwable t) {
        System.out.println("Operation Finished!");

Query for Locations Near a GeoJSON Point

MongoDB provides various geospatial query operators. To facilitate the creation of geospatial queries filters, the Java driver provides the Filters class and the com.mongodb.client.model.geojson package.

The following example returns documents that are at least 1000 meters from and at most 5000 meters from the specified GeoJSON point com.mongodb.client.model.geojson.Point, sorted from nearest to farthest:

Point refPoint = new Point(new Position(-73.9667, 40.78));
collection.find(Filters.near("contact.location", refPoint, 5000.0, 1000.0))
          .forEach(printBlock, callbackWhenFinished);