カテゴリ:

地理空間関数

ST_LENGTH

GEOGRAPHY オブジェクト内におけるラインストリングの測地線の長さをメートル単位で返します。

構文

ST_LENGTH( <geography_expression> )

引数

地理式

引数は GEOGRAPHY 型でなければなりません。

戻り値

メートル単位の長さを表す REAL 値を返します。

使用上の注意

  • 地理式 が LineString、 MultiLineString、またはラインストリングを含む GeometryCollection ではない場合、 ST_LENGTH は0を返します。

  • 地理式 が GeometryCollection の場合、 ST_LENGTH はコレクション内の線ストリングの長さの合計を返します。

  • ポリゴンの周囲の長さが必要な場合は、代わりに ST_PERIMETER 関数を使用してください。

これは、赤道での1°の弧の長さをメートル単位で示しています。

SELECT ST_LENGTH(TO_GEOGRAPHY('LineString(0.0 0.0, 1.0 0.0)'));
+---------------------------------------------------------+
| ST_LENGTH(TO_GEOGRAPHY('LINESTRING(0.0 0.0, 1.0 0.0)')) |
|---------------------------------------------------------|
|                                        111195.101177484 |
+---------------------------------------------------------+