2016-08-21 20:59:57 +10:00
|
|
|
{
|
|
|
|
"name": "line_interpolate_point",
|
|
|
|
"type": "function",
|
2020-07-02 01:46:48 +01:00
|
|
|
"groups": ["GeometryGroup"],
|
2016-08-21 20:59:57 +10:00
|
|
|
"description": "Returns the point interpolated by a specified distance along a linestring geometry.",
|
2022-01-07 08:33:29 -05:00
|
|
|
"arguments": [{
|
|
|
|
"arg": "geometry",
|
|
|
|
"description": "a linestring geometry"
|
|
|
|
}, {
|
|
|
|
"arg": "distance",
|
|
|
|
"description": "distance along line to interpolate"
|
|
|
|
}],
|
|
|
|
"examples": [{
|
2022-08-21 14:13:42 +02:00
|
|
|
"expression": "geom_to_wkt(line_interpolate_point(geometry:=geom_from_wkt('LineString(0 0, 8 0)'), distance:=5))",
|
2022-01-07 08:33:29 -05:00
|
|
|
"returns": "'Point (5 0)'"
|
2022-08-21 14:13:42 +02:00
|
|
|
}, {
|
|
|
|
"expression": "geom_to_wkt(line_interpolate_point(geometry:=geom_from_wkt('LineString(0 0, 1 1, 2 0)'), distance:=2.1))",
|
|
|
|
"returns": "'Point (1.48492424 0.51507576)'"
|
|
|
|
}, {
|
|
|
|
"expression": "geom_to_wkt(line_interpolate_point(geometry:=geom_from_wkt('LineString(0 0, 1 0)'), distance:=2))",
|
|
|
|
"returns": "NULL"
|
2022-01-07 08:33:29 -05:00
|
|
|
}],
|
2022-01-12 10:26:38 -05:00
|
|
|
"tags": ["distance", "interpolated", "linestring", "point", "specified", "along"]
|
2016-08-21 20:59:57 +10:00
|
|
|
}
|