次の方法で共有

MultiPolygon

  • [アーティクル]

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

Polygon インスタンス

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

geometry 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 インスタンスの内部が互いに重なっているため無効です。

使用例

次の例では、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();

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

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

関連項目

参照

STArea (geometry データ型)

STCentroid (geometry データ型)

STPointOnSurface (geometry データ型)

概念

Polygon

空間データ (SQL Server)