curve-expression.ST_Length([ unit-name])

Die ST_Length-Methode gibt die Länge einer Kurve in den Einheiten zurück, die durch den unit-name-Parameter festgelegt sind. Wenn die Kurve leer ist, wird NULL zurückgegeben.

Wenn die Kurve Z-Werte enthält, werden diese beim Berechnen der Länge der Geometrie nicht in Betracht gezogen.

• ST_Length-Methode für den ST_MultiCurve-Datentyp
• ST_Area-Methode für den ST_Surface-Datentyp

Das folgende Beispiel gibt den Wert 2 zurück.

SELECT NEW ST_LineString( 'LineString(1 0, 1 1, 2 1)' ).ST_Length()

Mit dem folgenden Beispiel wird eine Kreisbogenfolge für einen Halbkreis erstellt und ST_Length für die Suche nach der Länge der Geometrie verwendet. Der Wert PI wird zurückgegeben.

SELECT NEW ST_CircularString( 'CircularString( 0 0, 1 1, 2 0 )' ).ST_Length()

Mit dem folgenden Beispiel wird eine Linienfolge erstellt, die einen Pfad von Halifax nach Waterloo in Kanada darstellt und ST_Length für die Suche nach der Länge des Pfads in Metern verwendet. Als Ergebnis wird 1361967.76789 zurückgegeben

SELECT NEW ST_LineString( 'LineString( -63.573566 44.646244, -80.522372 43.465187 )', 4326 )
		.ST_Length()

Das folgende Beispiel gibt die Länge der Kurven in der SpatialShapes-Tabelle zurück. Die Längen werden in kartesischen Einheiten zurückgegeben.

SELECT ShapeID, TREAT( Shape AS ST_Curve ).ST_Length()
FROM SpatialShapes WHERE Shape IS OF ( ST_Curve )

Mit dem folgenden Beispiel wird eine Linienfolge und eine Beispielmaßeinheit (example_unit_halfmetre) erstellt. Die ST_Length-Methode findet die Länge des Geometrie in dieser Maßeinheit. Der Wert 4.0 wird zurückgegeben.

BEGIN
    DECLARE @curve ST_Curve;
    CREATE SPATIAL UNIT OF MEASURE IF NOT EXISTS  "example_unit_halfmetre" TYPE LINEAR CONVERT USING .5;
    SET @curve = NEW ST_LineString( 'LineString(1 0, 1 1, 2 1)' ) ;
    SELECT @curve.ST_Length('example_unit_halfmetre');
END