MultiPolygon
適用対象: SQL Server Azure SQL データベース Azure 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 インスタンスであるか、次の条件を満たす場合に有効です。
MultiPolygon インスタンスを構成するすべてのインスタンスは有効な Polygon インスタンスです。 有効な Polygon インスタンスについては、「 Polygon」を参照してください。
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)