DOCS-3109: added example output, documented output

Signed-off-by: kay <[email protected]>

Author: TimSlavinMongoDB

source/reference/command/geoNear.txt

@@ -60,3 +60,117 @@ To query a :doc:`2d </core/2d>` index, use:
    { geoNear : <collection> , near : [ <coordinates> ] }
 
 .. read-lock, slave-ok
+
+Example
+-------
+
+The following runs the :dbcommand:`geoNear` command on the collection ``places``:
+
+.. code-block:: javascript
+
+   db.runCommand( { geoNear : "places", 
+                    near : { type : "Point", 
+                             coordinates : [ -74.00, 40.00 ] },
+                    spherical : true } )
+
+This operation returns the following output:
+
+.. code-block:: javascript
+
+   {
+       "results" : [
+           {
+               "dis" : 85753.24625705236,
+               "obj" : {
+                   "_id" : ObjectId("536943463d2edb9288571e55"),
+                   "loc" : {
+                       "type" : "Point",
+                       "coordinates" : [
+                           -73.97,
+                           40.77
+                       ]
+                   },
+                   "name" : "Central Park",
+                   "category" : "Parks"
+               }
+           },
+           {
+               "dis" : 87422.73772813451,
+               "obj" : {
+                   "_id" : ObjectId("536943603d2edb9288571e56"),
+                   "loc" : {
+                       "type" : "Point",
+                       "coordinates" : [
+                           -73.88,
+                           40.78
+                       ]
+                   },
+                   "name" : "La Guardia Airport",
+                   "category" : "Airport"
+               }
+           }
+       ],
+       "stats" : {
+           "nscanned" : NumberLong(32),
+           "objectsLoaded" : NumberLong(32),
+           "avgDistance" : 86587.99199259344,
+           "maxDistance" : 87422.73772813451,
+           "time" : 2
+       },
+       "ok" : 1
+   }
+
+Output
+------
+
+The :dbcommand:`geoNear` command returns a document with the
+following fields:
+
+.. data:: geoNear.results
+
+   An array with the results of the :dbcommand:`geoNear` command, sorted
+   by distance with the nearest result listed first and farthest last.
+
+.. data:: geoNear.results[n].dis
+
+   For each document in the results, the distance from the coordinates
+   defined in the :dbcommand:`geoNear` command.
+
+.. data:: geoNear.results[n].obj
+
+   The document from the collection.
+
+.. data:: geoNear.stats
+
+   An object with statistics about the query used to return the results of
+   the :dbcommand:`geoNear` search.
+
+.. data:: geoNear.stats.nscanned
+
+   The total number of index entries scanned during the database operation.
+
+.. data:: geoNear.stats.objectsLoaded
+
+   The total number of documents read from disk during the database operation.
+
+.. data:: geoNear.stats.avgDistance
+
+   The average distance between the coordinates defined in the
+   :dbcommand:`geoNear` command and coordinates of the documents returned
+   as results.
+
+.. data:: geoNear.stats.maxDistance
+
+   The maximum distance between the coordinates defined in the
+   :dbcommand:`geoNear` command and coordinates of the documents returned
+   as results.
+
+.. data:: geoNear.stats.time
+
+   The execution time of the database operation, in milliseconds.
+
+.. data:: geoNear.ok
+
+   A value of ``1`` indicates the :dbcommand:`geoNear` search succeeded. A
+   value of ``0`` indicates an error.
+