(DOCSP-32327): Atlas top 250 Geospatial query revamp (#4819)

* Draft tabbed procedures to get started

* Add steps to query geospatial data in the Atlas UI

* Add links to Atlas docs

* Apply suggestions from review

Co-authored-by: Sarah Simpers <[email protected]>

* Remove Search

* Switch to procedures with lists

* Switch the refs to pipeline links

* Fix broken pipeline links

---------

Co-authored-by: Sarah Simpers <[email protected]>

Author: dacharyc

source/geospatial-queries.txt

@@ -22,7 +22,15 @@ Geospatial Queries
    :class: singlecol
 
 MongoDB supports query operations on geospatial data. This section
-introduces MongoDB's geospatial features.
+introduces MongoDB's geospatial features. 
+
+.. |page-topic| replace:: run geospatial queries
+
+.. include:: /includes/fact-atlas-compatible.rst
+
+For deployments hosted in {+atlas+}, you can run geospatial 
+queries in the UI by using the query :guilabel:`Filter` bar or aggregation 
+builder. To learn more, see :ref:`geospatial-queries-atlas`.
 
 .. _geo-overview-location-data:
 
@@ -279,6 +287,156 @@ query, used by each geospatial operations:
      - Flat
      -
 
+.. _geospatial-queries-atlas:
+
+Perform Geospatial Queries in Atlas
+-----------------------------------
+
+.. tabs::
+
+   .. tab:: Query Filter Bar
+      :tabid: filter-bar
+
+      You can use the {+atlas+} UI
+      to perform geospatial queries in Atlas. 
+
+      .. procedure::
+        :style: normal
+
+        .. step:: Create an index
+
+           If your geospatial collection does not already have a geospatial
+           index, you must create one.
+
+           1. Select the database for the collection.
+
+              The main panel and :guilabel:`Namespaces` on the left side 
+              list the collections in the database.
+          
+           #. Select the collection.
+
+              Select the collection that contains your geospatial data on 
+              the left-hand side or in the main panel. The main panel displays 
+              the :guilabel:`Find`, :guilabel:`Indexes`, and 
+              :guilabel:`Aggregation` views.
+
+           #. Select the Index view.
+                
+              When you open the :guilabel:`Index` view, Atlas
+              displays any indexes that exist on the collection.
+
+           #. Define the Index for the geo Type
+
+              Press the :guilabel:`Create Index` button. 
+
+              Define a geo Type index. Refer to 
+              `How to Index GeoJSON Objects <https://www.mongodb.com/docs/atlas/atlas-search/field-types/geo-type/>`__.
+
+        .. step:: Query the geospatial data 
+
+           1. Select the Find view.
+
+              From the collection that contains your geospatial
+              data, select the :guilabel:`Find` tab to view your geospatial 
+              collection.
+
+           #. Enter a query.
+
+              Enter a query in the :guilabel:`Filter` text box. Use
+              any of the :ref:`geospatial query operators 
+              <geospatial-operators>` to perform the relevant query
+              on your geospatial data. A geospatial query might resemble:
+
+              .. code-block:: javascript
+
+                  { 
+                    "coordinates": { 
+                      $geoWithin: { 
+                        $geometry: { 
+                          type: "Polygon", 
+                          coordinates: [ 
+                            [ 
+                              [-80.0, 10.00], [ -80.0, 9.00], [ -79.0, 9.0], [ -79.0, 10.00 ], [ -80.0, 10.0 ] 
+                            ] 
+                          ] 
+                        } 
+                      } 
+                    } 
+                  }
+
+           #. Press the Apply button.
+
+              Press the :guilabel:`Apply` button to apply your query.
+              Atlas filters the geospatial data to show only documents
+              that match your geospatial query.
+
+   .. tab:: Aggregation
+      :tabid: aggregation
+
+      You can create and execute aggregation pipelines to perform geospatial
+      queries in the {+atlas+} UI.
+
+      .. procedure::
+        :style: normal
+
+        .. step:: Access the aggregation pipeline builder
+
+           1. Select the database for the collection.
+
+              The main panel and :guilabel:`Namespaces` on the left side list the
+              collections in the database.
+
+           #. Select the collection.
+
+              Select the collection that contains your geospatial data on 
+              the left-hand side or in the main panel. The main panel displays 
+              the :guilabel:`Find`, :guilabel:`Indexes`, and 
+              :guilabel:`Aggregation` views.
+
+           #. Select the Aggregation view.
+                
+              When you first open the :guilabel:`Aggregation` view, Atlas
+              displays an empty aggregation pipeline.
+
+        .. step:: Create your geospatial query aggregation pipeline
+
+           1. Select an aggregation stage.
+
+              Select an aggregation stage from the :guilabel:`Select` dropdown in
+              the bottom-left panel.
+
+              The toggle to the right of the dropdown dictates whether the
+              stage is enabled.
+
+              Use the :pipeline:`$geoNear` stage to perform geospatial
+              queries in your aggregation pipeline.
+
+           #. Fill in your aggregation stage.
+
+              Fill in your stage with the appropriate values. 
+              If :ref:`Comment Mode <pipeline-settings>` is enabled, the pipeline
+              builder provides syntactic guidelines for your selected stage. 
+
+              As you modify your stage, Atlas updates the preview documents on
+              the right based on the results of the current stage.
+
+              Your :pipeline:`$geoNear` stage may resemble:
+
+              .. code-block:: javascript
+
+                  {
+                    near: { type: "Point", coordinates: [ -73.9667, 40.78 ] },
+                    spherical: true,
+                    query: { category: "Parks" },
+                    distanceField: "calcDistance"
+                  }
+
+           #. Run other pipeline stages as needed.
+
+              Add stages as needed to complete your aggregation pipeline. 
+              You might add :pipeline:`$out` or 
+              :pipeline:`$merge` to write the results to a 
+              view or the current collection.
 
 .. _geospatial-query-examples: