MultiPolygon

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

MultiPolygon インスタンスは、0 個以上の Polygon インスタンスのコレクションです。

Polygon インスタンス

次の図は、 MultiPolygon インスタンスの例です。

この図は次のことを示しています。

• 図 1 は、2 つの Polygon 要素がある MultiPolygon インスタンスです。 境界は、2 つの外部リングと 3 つの内部リングによって定義されています。

• 図 2 は、2 つの Polygon 要素がある MultiPolygon インスタンスです。 境界は、2 つの外部リングと 3 つの内部リングによって定義されています。 2 つの Polygon 要素は接点で交差しています。

許容されるインスタンス

次のいずれかの条件が満たされている場合、 MultiPolygon インスタンスは許容されます。

• これは空の MultiPolygon インスタンスです。

• MultiPolygon を構成するすべてのインスタンスは、許容される Polygon インスタンスです。 許容される Polygon インスタンスの詳細については、「 Polygon」を参照してください。

次の例に、許容される MultiPolygon インスタンスを示します。

DECLARE @g1 geometry = 'MULTIPOLYGON EMPTY';  
DECLARE @g2 geometry = 'MULTIPOLYGON(((1 1, 1 -1, -1 -1, -1 1, 1 1)),((1 1, 3 1, 3 3, 1 3, 1 1)))';  
DECLARE @g3 geometry = 'MULTIPOLYGON(((2 2, 2 -2, -2 -2, -2 2, 2 2)),((1 1, 3 1, 3 3, 1 3, 1 1)))';  

次の例に、 System.FormatExceptionをスローする MultiPolygon インスタンスを示します。

DECLARE @g geometry = 'MULTIPOLYGON(((1 1, 1 -1, -1 -1, -1 1, 1 1)),((1 1, 3 1, 3 3)))';  

MultiPolygon の 2 番目のインスタンスは LineString インスタンスであり、許容される Polygon インスタンスではありません。

有効なインスタンス

MultiPolygon インスタンスは、空の MultiPolygon インスタンスであるか、次の条件を満たす場合に有効です。

1. MultiPolygon インスタンスを構成するすべてのインスタンスは有効な Polygon インスタンスです。 有効な Polygon インスタンスについては、「 Polygon」を参照してください。

2. MultiPolygon インスタンスを構成する Polygon インスタンスは重複しません。

次に、2 つの有効な MultiPolygon インスタンスと 1 つの無効な MultiPolygon インスタンスの例を示します。

DECLARE @g1 geometry = 'MULTIPOLYGON EMPTY';  
DECLARE @g2 geometry = 'MULTIPOLYGON(((1 1, 1 -1, -1 -1, -1 1, 1 1)),((1 1, 3 1, 3 3, 1 3, 1 1)))';  
DECLARE @g3 geometry = 'MULTIPOLYGON(((2 2, 2 -2, -2 -2, -2 2, 2 2)),((1 1, 3 1, 3 3, 1 3, 1 1)))';  
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid();  

@g2 は、2 つの Polygon インスタンスが 1 つの接点のみで接しているため有効です。 @g3 は、2 つの Polygon インスタンスの内部が互いに重なっているため無効です。

例

例 A.

次の例では、 geometry``MultiPolygon インスタンスを作成し、2 つ目の構成要素の Well-Known Text (WKT) を返します。

DECLARE @g geometry;  
SET @g = geometry::Parse('MULTIPOLYGON(((0 0, 0 3, 3 3, 3 0, 0 0), (1 1, 1 2, 2 1, 1 1)), ((9 9, 9 10, 10 9, 9 9)))');  
SELECT @g.STGeometryN(2).STAsText();  

例 B。

次の例では、空の MultiPolygon インスタンスを作成します。

DECLARE @g geometry;  
SET @g = geometry::Parse('MULTIPOLYGON EMPTY');  

参照

Polygon
STArea (geometry データ型)
STCentroid (geometry データ型)
STPointOnSurface (geometry データ型)
空間データ (SQL Server)