## Top 5 Recent Articles

##### ARTICLES CATEGORIES

- Changes (1)
- General Software (3)
- Licensing (1)
- MySQL Spatial (2)
- Oracle Spatial (3)
- PostGIS (6)
- SQL Server Spatial (General) (6)
- SQL Server Spatial (LRS) (37)
- XML (2)

# STLineLocatePoint

**STLineLocatePoint** — Returns a float between 0 and 1 representing the location of the closest point on LineString to the given Point

**Function Specification.**

Function [$(lrsowner)].[STLineLocatePoint] ( @p_linestring geometry, @p_point geometry, @p_round_xy int = 3, @p_round_zm int = 2 ) Returns geometry

**Description.**

This function, given a point near a the supplied measure @p_linestring, returns the measure/length ratio of the found position.

**Notes.**

Is identical to PostGIS’s ST_LineLocatePoint.

Srid of @p_linestring and @p_point must be the same.

If @p_linestring is measured ratio returned is measure of located point / MeasureRange of linestring.

If @p_linestring is not measured the ratio returned is position of located point from start / STLenth of linestring.

**Parameters.**

@p_linestring (geometry) - Linestring geometry with or without measures. @p_point (geometry) - Point near to linestring. @p_round_xy (int) - Decimal degrees of precision to which calculated XY ordinates are rounded. @p_round_zm (int) - Decimal degrees of precision to which calculated ZM ordinates are rounded.

**Result.**

The function returns the ratio of the position of the point on @p_linestring using measure/measure range or length/total length.

**Example.**

select [lrs].[STLineLocatePoint] ( 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), default, default ) as ratio union all select [lrs].[STLineLocatePoint] ( geometry::STGeomFromText('LINESTRING(-4 -4,0 0,10 0,10 10)',28355), geometry::Point(10,0,28355), 4, 8 ) as ratio GO ratio 23.44 15.6

## Documentation

- MySQL Spatial General Function Documentation
- Oracle Spatial Exporter Package Documentation
- Oracle Spatial Object Function Documentation
- Oracle Spatial Object Function Documentation (Multi Page Version)
- PostGIS pl/pgSQL Function Documentation
- SC4O Oracle Java Topology Suite (Stored Procedures) Package Documentation
- SQL Server Spatial General TSQL Function Documentation
- SQL Server Spatial LRS TSQL Function Documentation