ST_Length メソッド

ST_MultiCurve 値の長さの測定値を返します。結果は、パラメーターで指定した単位で測定されます。

構文

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

パラメーター

名前	型	説明
unit-name	VARCHAR(128)	長さを計算する単位。デフォルトでは、空間参照系の単位が使用されます。単位名は、UNIT_TYPE が 'LINEAR' の ST_UNITS_OF_MEASURE ビュー内のローの UNIT_NAME カラムと一致させてください。

戻り値

備考

ST_Length メソッドは、unit-name パラメーターで指定された単位で複数曲線の長さを返します。複数曲線の長さは、含まれている曲線の長さの合計です。曲線が空の場合は、NULL が返されます。

曲線に Z 値が含まれている場合、それらの値はジオメトリの長さの計算時には考慮されません。

注意

multicurve-expression が空のジオメトリ (ST_IsEmpty()=1) の場合、このメソッドは NULL を返します。

注意

ST_Length では、デフォルトで、使用可能な場合はジオメトリの元のフォーマットが使用されます。それ以外の場合は、内部フォーマットが使用されます。内部フォーマットと元のフォーマットの詳細については、STORAGE FORMAT 句、CREATE SPATIAL REFERENCE SYSTEM 文を参照してください。

参照

標準と互換性

例

次の例では、複数曲線を作成し、ST_Length を使用してジオメトリの長さを調べ、値 PI+1 を返します。

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

次の例では、100 マイルを超える道路の名前と長さを返します。この例では、road テーブルが存在しており、geometry カラムのタイプが ST_MultiCurve または ST_MultiLineString で、st_geometry_predefined_uom のロードに sa_install_feature システムプロシージャーが使用されているものとします。

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

DocCommentXchange で意見交換できます