- Reference >
- Operators >
- Query and Projection Operators >
- Geospatial Query Operators >
- $geometry
$geometry¶
-
$geometry
¶ New in version 2.4.
Changed in version 3.0: Add support to specify single-ringed GeoJSON polygons with areas greater than a single hemisphere.
The
$geometry
operator specifies a GeoJSON geometry for use with the following geospatial query operators:$geoWithin
,$geoIntersects
,$near
, and$nearSphere
.$geometry
usesEPSG:4326
as the default coordinate reference system (CRS).To specify GeoJSON objects with the default CRS, use the following prototype for
$geometry
:$geometry: { type: "<GeoJSON object type>", coordinates: [ <coordinates> ] }
New in version 3.0: To specify a single-ringed GeoJSON polygon with a custom MongoDB CRS, use the following prototype (available only for
$geoWithin
and$geoIntersects
):$geometry: { type: "Polygon", coordinates: [ <coordinates> ], crs: { type: "name", properties: { name: "urn:x-mongodb:crs:strictwinding:EPSG:4326" } } }
The custom MongoDB coordinate reference system has a strict counter-clockwise winding order.
Important
If specifying latitude and longitude coordinates, list the longitude first and then latitude:
- Valid longitude values are between
-180
and180
, both inclusive. - Valid latitude values are between
-90
and90
(both inclusive).
- Valid longitude values are between