Ticket #12410: line_locate_point.patch

django/contrib/gis/db/models/manager.py

@@ -88 +88 @@
     def translate(self, *args, **kwargs):
         return self.get_query_set().translate(*args, **kwargs)
 
+    def line_locate_point(self, *args, **kwargs):
+        return self.get_query_set().line_locate_point(*args, **kwargs)
+
     def union(self, *args, **kwargs):
         return self.get_query_set().union(*args, **kwargs)
 

django/contrib/gis/db/models/query.py

@@ -375 +375 @@
         self.query.custom_select[geo_field] = custom_sel
         return self._clone()
 
+    def line_locate_point(self, geom, **kwargs):
+        """
+        Return a float between 0 and 1 representing the location of the
+        closest point on the LineString passed to the specified PointField.
+        """
+        if SpatialBackend.postgis:
+            s = {'geom_args' : ('geom',),
+                 'procedure_fmt' : '%(geom)s,%(geo_col)s',
+                 'procedure_args' : {'geom': geom},
+                 }
+        else:
+            raise NotImplementedError('backend does not support line_locate_point')
+        return self._spatial_attribute('line_locate_point', s, **kwargs)
+
     def union(self, geom, **kwargs):
         """
         Returns the union of the geographic field with the given

django/contrib/gis/db/backend/postgis/__init__.py

@@ -41 +41 @@
                                     sym_difference=SYM_DIFFERENCE,
                                     transform=TRANSFORM,
                                     translate=TRANSLATE,
+                                    line_locate_point=LINE_LOCATE_POINT,
                                     union=UNION,
                                     unionagg=UNIONAGG,
                                     version=(MAJOR_VERSION, MINOR_VERSION1, MINOR_VERSION2),

django/contrib/gis/db/backend/postgis/query.py

@@ -84 +84 @@
     SYM_DIFFERENCE = get_func('SymDifference')
     TRANSFORM = get_func('Transform')
     TRANSLATE = get_func('Translate')
+    LINE_LOCATE_POINT = get_func('Line_Locate_Point')
 
     # Special cases for union, KML, and GeoJSON methods.
     if MINOR_VERSION1 < 3: