📣
TiDB Cloud Premium is now in public preview. Unlimited growth, instant elasticity, advanced security for enterprise workloads. Try it out →

ST_LENGTH



Returns the Euclidean length of the LineString(s) in a GEOMETRY or GEOGRAPHY object.

Syntax

ST_LENGTH(<geometry_or_geography>)

Arguments

ArgumentsDescription
<geometry_or_geography>The argument must be an expression of type GEOMETRY or GEOGRAPHY containing linestrings.

Return Type

Double.

Examples

GEOMETRY examples

SELECT ST_LENGTH(TO_GEOMETRY('POINT(1 1)')) AS length ┌─────────┐ │ length │ ├─────────┤ │ 0 │ └─────────┘ SELECT ST_LENGTH(TO_GEOMETRY('LINESTRING(0 0, 1 1)')) AS length ┌─────────────┐ │ length │ ├─────────────┤ │ 1.414213562 │ └─────────────┘ SELECT ST_LENGTH( TO_GEOMETRY('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))') ) AS length ┌─────────┐ │ length │ ├─────────┤ │ 0 │ └─────────┘

GEOGRAPHY examples

SELECT ST_LENGTH( ST_GEOGFROMWKT( 'LINESTRING(0 0, 1 0)' ) ) AS length ╭──────────────────╮ │ length │ ├──────────────────┤ │ 111319.490793274 │ ╰──────────────────╯

Was this page helpful?