p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Fixed #25498 -- Documented ST_Distance/ST_Distance_Sphere difference 

Thanks Bibhas Debnath for the report and Tim Graham for the review.
This commit is contained in:
Claude Paroz 2015-10-09 17:15:16 +02:00
parent 67732a9b18
commit 617b1a21f5
1 changed files with 18 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
docs/ref/contrib/gis/geoquerysets.txt
View File

@ -523,7 +523,8 @@ With PostGIS, on every distance lookup but :lookup:`dwithin`, an optional
third element, ``'spheroid'``, may be included to tell GeoDjango
to use the more accurate spheroid distance calculation functions on
fields with a geodetic coordinate system (e.g., ``ST_Distance_Spheroid``
would be used instead of ``ST_Distance_Sphere``).
would be used instead of ``ST_Distance_Sphere``). The simpler ``ST_Distance``
function is used with projected coordinate systems.
.. versionadded:: 1.10
@ -541,13 +542,13 @@ Example::
Zipcode.objects.filter(poly__distance_gt=(geom, D(m=5)))
========== ===============================================
========== ==================================================
Backend SQL Equivalent
========== ===============================================
PostGIS ``ST_Distance(poly, geom) > 5``
========== ==================================================
PostGIS ``ST_Distance/ST_Distance_Sphere(poly, geom) > 5``
Oracle ``SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) > 5``
SpatiaLite ``Distance(poly, geom) > 5``
========== ===============================================
========== ==================================================
.. fieldlookup:: distance_gte
@ -561,13 +562,13 @@ Example::
Zipcode.objects.filter(poly__distance_gte=(geom, D(m=5)))
========== ================================================
========== ===================================================
Backend SQL Equivalent
========== ================================================
PostGIS ``ST_Distance(poly, geom) >= 5``
========== ===================================================
PostGIS ``ST_Distance/ST_Distance_Sphere(poly, geom) >= 5``
Oracle ``SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) >= 5``
SpatiaLite ``Distance(poly, geom) >= 5``
========== ================================================
========== ===================================================
.. fieldlookup:: distance_lt
@ -581,13 +582,13 @@ Example::
Zipcode.objects.filter(poly__distance_lt=(geom, D(m=5)))
========== ===============================================
========== ==================================================
Backend SQL Equivalent
========== ===============================================
PostGIS ``ST_Distance(poly, geom) < 5``
========== ==================================================
PostGIS ``ST_Distance/ST_Distance_Sphere(poly, geom) < 5``
Oracle ``SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) < 5``
SpatiaLite ``Distance(poly, geom) < 5``
========== ===============================================
========== ==================================================
.. fieldlookup:: distance_lte
@ -601,13 +602,13 @@ Example::
Zipcode.objects.filter(poly__distance_lte=(geom, D(m=5)))
========== ================================================
========== ===================================================
Backend SQL Equivalent
========== ================================================
PostGIS ``ST_Distance(poly, geom) <= 5``
========== ===================================================
PostGIS ``ST_Distance/ST_Distance_Sphere(poly, geom) <= 5``
Oracle ``SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) <= 5``
SpatiaLite ``Distance(poly, geom) <= 5``
========== ================================================
========== ===================================================
.. fieldlookup:: dwithin