ST_Length-Methode

Gibt die Längenmessung des ST_MultiCurve-Werts zurück. Das Ergebnis wird mit den Einheiten gemessen, die durch den Parameter festgelegt sind.

Syntax

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

Parameter

Name	Typ	Beschreibung
unit-name	VARCHAR(128)	Die Einheiten, in denen die Länge berechnet werden soll. Ist standardmäßig die Einheit des räumlichen Bezugssystems. Der unit-name-Parameter muss mit der UNIT_NAME-Spalte einer Zeile in der ST_UNITS_OF_MEASURE-Ansicht übereinstimmen, wo UNIT_TYPE auf 'LINEAR' eingestellt ist.

Die ST_Length-Methode gibt die Länge einer Mehrfachkurve in den Einheiten zurück, die durch den unit_name-Parameter festgelegt sind. Die Länge einer Mehrfachkurve ist die Summe der Längen der enthaltenen Kurven. 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.

Hinweis

Wenn multicurve-expression eine leere Geometrie (ST_IsEmpty()=1) ist, gibt diese Methode NULL zurück.

Hinweis

Standardmäßig verwendet ST_LENGTH das Originalformat für eine Geometrie, wenn es verfügbar ist. Andernfalls wird das interne Format verwendet. Weitere Hinweise zu den internen Formaten und Originalformaten finden Sie unter STORAGE FORMAT-Klausel, CREATE SPATIAL REFERENCE SYSTEM-Anweisung.

Siehe auch

Standards und Kompatibilität

Beispiel

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

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

Das folgende Beispiel gibt den Namen und die Länge aller Straßen zurück, die länger als 100 Meilen sind. In diesem Beispiel wird davon ausgegangen, dass die Tabelle road vorhanden ist, dass die Geometriespalte vom Typ ST_MultiCurve oder ST_MultiLineString ist und die sa_install_feature-Systemprozedur verwendet wurde, um st_geometry_predefined_uom zu laden.

SELECT name, geometry.ST_Length( 'Statute Mile' ) len
FROM roads WHERE len > 100

Kommentieren Sie diese Seite in DocCommentXchange.