STUnion (geography データ型)

[アーティクル]
05/23/2023

適用対象:SQL Server Azure SQL Database Azure SQL Managed Instance

geography インスタンスと別の geography インスタンスの和集合を表すオブジェクトを返します。

構文

  
.STUnion ( other_geography )

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

other_geography
STUnion() を呼び出したインスタンスとの和集合を形成する、別の geography インスタンスです。

戻り値の型

SQL Server 戻り値の型: geography

CLR の戻り値の型: SqlGeography

例外

このメソッドは、このインスタンスに対蹠点が含まれている場合、ArgumentException をスローします。

解説

geography インスタンスの SRID (spatial reference ID) が一致しない場合、このメソッドは常に null を返します。

SQL Server では、半球より大きい空間インスタンスをサポートしています。 SQL Server では、サーバー上で返される結果セットが FullGlobe インスタンスに拡張されています。

結果に円弧が含まれるのは、入力インスタンスに円弧が含まれる場合のみです。

このメソッドは正確ではありません。

例

A. 2 つの多角形の和集合を計算する

STUnion() を使用して 2 つの Polygon インスタンスの和集合を計算する例を次に示します。

DECLARE @g geography;  
DECLARE @h 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);  
SET @h = geography::STGeomFromText('POLYGON((-122.351 47.656, -122.341 47.656, -122.341 47.661, -122.351 47.661, -122.351 47.656))', 4326);  
SELECT @g.STUnion(@h).ToString();

B. FullGlobe の結果を生成する

FullGlobe で 2 つの STUnion() インスタンスを結合するときに、Polygon を生成する例を次に示します。

 DECLARE @g geography = 'POLYGON ((-122.358 47.653, -122.358 47.658,-122.348 47.658, -122.348 47.649, -122.358 47.653))';  
 DECLARE @h geography = 'POLYGON ((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))';  
 SELECT @g.STUnion(@h).ToString();

C. CurvePolygon と Polygon の和集合から三角形の穴を生成する。

CurvePolygon と Polygon インスタンスの和集合から三角形の穴を生成する例を次に示します。

 DECLARE @g geography = 'POLYGON ((-0.5 0, 0 1, 0.5 0.5, -0.5 0))';  
 DECLARE @h geography = 'CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(0 0, 0.7 0.7, 0 1), (0 1, 0 0)))';  
 SELECT @g.STUnion(@h).ToString();

参照

Geography インスタンスの OGC メソッド