STProjectPoint — Returns a measured point by snapping provided point to the provided line.
Function [lrs].[STProjectPoint] ( @p_linestring geometry, @p_point geometry, @p_round_xy int = 3, @p_round_zm int = 2 ) Returns geometry
This function snaps supplied point to @p_linestring, returning the snapped point.
If there is more than one possible solution the first point is retuend.
Computes Z and M values if exist on @p_linestring.
If input @p_linestring is 2D, length from start of @p_linestring to point is returned in M ordinate of snapped point.
Returned points ordinate values are rounded to @p_round_xy/@p_round_zm decimal digits of precision.
Supports linestrings with CircularString elements.
@p_linestring (geometry) - Measured linestring with or without Z ordinates. @p_point (geometry) - Point near to linestring. @p_round_xy (int) - Decimal digits of precision for XY ordinates. @p_round_zm (int) - Decimal digits of precision for M ordinate.
The function snaps the supplied @p_point to @p_linestring computing XY, Z (if exists) and M ordinate values.
select CAST('Actual Measure' as varchar(20)) as test, [lrs].[STProjectPoint] ( geometry::STGeomFromText('LINESTRING(-4 -4 0 1, 0 0 0 5.6, 10 0 0 15.61, 10 10 0 25.4)',28355), geometry::Point(8,8,28355), 3,2).AsTextZM() as project_point union all select '2D return length in measure' as test, [lrs].[STProjectPoint] ( geometry::STGeomFromText('LINESTRING(-4 -4, 0 0, 10 0, 10 10)',28355), geometry::Point(8,8,28355), 3,2).AsTextZM() as project_point GO test project_point Actual Measure POINT (10 8 NULL 23.44) 2D return length in measure POINT (10 8 NULL 23.66)