multisurface-expression.ST_Perimeter([ unit-name])

ST_Perimeter メソッドは、unit-name パラメーターで指定された単位で複数面の周囲の長さを返します。複数面が空の場合は、NULL が返されます。

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

多角形の周囲の長さには、すべてのリング (外部と内部) の長さが含まれます。

• ST_Surface タイプの ST_Perimeter メソッド
• ST_Geometry タイプの ST_Boundary メソッド
• ST_MultiCurve タイプの ST_Length メソッド

次の例では、2 つの多角形を含む複数面を作成し、ST_Perimeter を使用して周囲の長さを調べ、結果として 44 を返します。

SELECT NEW ST_MultiSurface( NEW ST_Polygon('Polygon((0 0, 1 0, 1 1,0 1, 0 0))')
			  , NEW ST_Polygon('Polygon((10 10, 20 10, 20 20,10 20, 10 10))') )
		.ST_Perimeter()

次の例では、2 つの多角形を含む複数面と測定単位の例 (example_unit_halfmetre) を作成します。ST_Perimeter は、周囲の長さを調べ、値 88.0 を返します。

CREATE SPATIAL UNIT OF MEASURE IF NOT EXISTS  "example_unit_halfmetre" TYPE LINEAR CONVERT USING .5;
SELECT NEW ST_MultiSurface( NEW ST_Polygon('Polygon((0 0, 1 0, 1 1,0 1, 0 0))')
			  , NEW ST_Polygon('Polygon((10 10, 20 10, 20 20,10 20, 10 10))') )
		.ST_Perimeter('example_unit_halfmetre');