From ad7f3c0b7baad3d2b46bebc4809e90d4853bc3c6 Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Fri, 6 Jan 2017 07:55:00 -0500 Subject: [PATCH] Refs #24688, #27497 -- Corrected docs: distance's 'spheroid' option isn't PostGIS specific. --- docs/ref/contrib/gis/geoquerysets.txt | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/ref/contrib/gis/geoquerysets.txt b/docs/ref/contrib/gis/geoquerysets.txt index cd8e8dabb1..99bc4afbe4 100644 --- a/docs/ref/contrib/gis/geoquerysets.txt +++ b/docs/ref/contrib/gis/geoquerysets.txt @@ -596,11 +596,12 @@ and a distance value (either a number in units of the field, a `). To pass a band index to the lookup, use a 3-tuple where the second entry is the band index. -With PostGIS, on every distance lookup but :lookup:`dwithin`, an optional -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``). The simpler ``ST_Distance`` function is used with +On every distance lookup except :lookup:`dwithin`, an optional element, +``'spheroid'``, may be included to use the more accurate spheroid distance +calculation functions on fields with a geodetic coordinate system. + +On PostgreSQL, the ``'spheroid'`` option uses ``ST_Distance_Spheroid`` instead +of ``ST_Distance_Sphere``. The simpler ``ST_Distance`` function is used with projected coordinate systems. Rasters are converted to geometries for spheroid based lookups. @@ -608,6 +609,10 @@ based lookups. The ability to pass an expression as the distance value was added. +.. versionadded:: 1.11 + + Support for the ``'spheroid'`` option on SQLite was added. + .. fieldlookup:: distance_gt ``distance_gt``