diff --git a/docs/ref/contrib/gis/geoquerysets.txt b/docs/ref/contrib/gis/geoquerysets.txt index b7bd83b3a3..d88454ed28 100644 --- a/docs/ref/contrib/gis/geoquerysets.txt +++ b/docs/ref/contrib/gis/geoquerysets.txt @@ -279,6 +279,21 @@ SpatiaLite ``Disjoint(poly, geom)`` *Availability*: `PostGIS `__, Oracle, MySQL, SpatiaLite, PGRaster (Conversion) +Tests if the geometry field is spatially equal to the lookup geometry. + +Example:: + + Zipcode.objects.filter(poly__equals=geom) + +========== ================================================= +Backend SQL Equivalent +========== ================================================= +PostGIS ``ST_Equals(poly, geom)`` +Oracle ``SDO_EQUAL(poly, geom)`` +MySQL ``MBREquals(poly, geom)`` +SpatiaLite ``Equals(poly, geom)`` +========== ================================================= + .. fieldlookup:: exact .. fieldlookup:: same_as @@ -288,6 +303,23 @@ Oracle, MySQL, SpatiaLite, PGRaster (Conversion) *Availability*: `PostGIS `__, Oracle, MySQL, SpatiaLite, PGRaster (Bilateral) +Tests if the geometry field is "equal" to the lookup geometry. On Oracle and +SpatiaLite it tests spatial equality, while on MySQL and PostGIS it tests +equality of bounding boxes. + +Example:: + + Zipcode.objects.filter(poly=geom) + +========== ================================================= +Backend SQL Equivalent +========== ================================================= +PostGIS ``poly ~= geom`` +Oracle ``SDO_EQUAL(poly, geom)`` +MySQL ``MBREquals(poly, geom)`` +SpatiaLite ``Equals(poly, geom)`` +========== ================================================= + .. fieldlookup:: intersects ``intersects``