DOCSP-38210: geospatial (#19)

Author: rustagir

source/tutorials.txt

@@ -15,11 +15,10 @@ Tutorials
    /tutorials/aggregation/
    /tutorials/change-stream/
    /tutorials/text-search/
+   /tutorials/geospatial/
 
-..
-   /tutorials/geo/
-   /tutorials/gridfs/
-   /tutorials/command/
+.. /tutorials/gridfs/
+.. /tutorials/command/
 
 - :ref:`scala-connect`
 - :ref:`scala-db-coll`
@@ -30,8 +29,7 @@ Tutorials
 - :ref:`scala-aggregation`
 - :ref:`scala-changestream`
 - :ref:`scala-text-search`
+- :ref:`scala-geospatial`
 
-.. 
-  - :ref:`scala-geo`
-  - :ref:`scala-gridfs`
-  - :ref:`scala-run-command`
+.. - :ref:`scala-gridfs`
+.. - :ref:`scala-run-command`

source/tutorials/geospatial.txt

@@ -0,0 +1,76 @@
+.. _scala-geospatial:
+
+=================
+Geospatial Search
+=================
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: code example, search coordinates, location
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+To support geospatial queries, MongoDB provides geospatial
+indexes and geospatial query operators.
+
+To learn more about performing geospatial queries, see
+:manual:`Geospatial Queries </geospatial-queries/>` in the
+Server manual.
+
+Prerequisites
+-------------
+
+.. include:: /includes/prereq-restaurants.rst
+
+.. code-block:: scala
+
+   import org.mongodb.scala._
+   import org.mongodb.scala.model.geojson._
+   import org.mongodb.scala.model.Indexes
+   import org.mongodb.scala.model.Filters
+
+.. include:: /includes/obs-note.rst
+
+Connect to a MongoDB Deployment
+-------------------------------
+
+.. include:: /includes/connect-section.rst
+
+Create a 2dsphere Index
+-----------------------
+
+To create a ``2dsphere`` index, use the ``Indexes.geo2dsphere()``
+helper to create a specification for the ``2dsphere`` index. Pass the
+specification to the ``MongoCollection.createIndex()`` method to create
+the index.
+
+The following example creates a ``2dsphere`` index on the
+``"contact.location"`` field in the collection:
+
+.. code-block:: scala
+
+   collection.createIndex(Indexes.geo2dsphere("contact.location")).printResults()
+
+Query for Locations Near a GeoJSON Point
+----------------------------------------
+
+MongoDB provides various geospatial query operators. To facilitate
+the creation of geospatial query filters, the driver provides
+the ``Filters`` class and the ``com.mongodb.client.model.geojson``
+package.
+
+The following example returns documents that are at least ``1000.0`` meters
+and at most ``5000.0`` meters from the specified GeoJSON ``Point`` instance,
+automatically sorted from nearest to farthest:
+
+.. code-block:: scala
+
+   val refPoint = Point(Position(-73.9667, 40.78))
+   collection.find(Filters.near("contact.location", refPoint, 5000.0, 1000.0)).printResults()