STArea (geography データ型)
geography インスタンスの合計面積を返します。STArea() の結果は、geography インスタンスの spatial reference identifier (SRID) が使用する測定単位の平方で返されます。たとえば、インスタンスの SRID が 4326 の場合、STArea() の結果は平方メートル単位で返されます。
構文
.STArea ( )
戻り値の型
SQL Server の戻り値の型 : float
CLR の戻り値の型 : SqlDouble
説明
geography インスタンスに含まれるすべての図形が 0 次元または 1 次元の図形の場合、STArea() は 0 を返します。
注意 |
---|
基準の戻り値を生成する、geography データ型のメソッドの結果は、メソッドで使用されるインスタンスの SRID に応じて異なります。SRID の詳細については、「SRID (Spatial Reference Identifier)」を参照してください。 |
例
STArea() を使用して、Polygongeography インスタンスを作成し、多角形の面積を計算する例を次に示します。
DECLARE @g geography;
SET @g = geography::STGeomFromText('POLYGON((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))', 4326);
SELECT @g.STArea();