STConvexHull (geography データ型)STConvexHull (geography Data Type)

適用対象: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

geography インスタンスの凸包を表すオブジェクトを返します。Returns an object that represents the convex hull of a geography instance.

構文Syntax

  
.STConvexHull ( )  

戻り値の型Return Types

SQL ServerSQL Server 戻り値の型: geographyreturn type: geography

CLR の戻り値の型:SqlGeographyCLR return type: SqlGeography

RemarksRemarks

エンベロープの角度が 90°より大きい geography インスタンスに対して FullGlobe オブジェクトを返します。Returns a FullGlobe object for geography instance which has an envelope angle larger than 90 degrees.

空の geography インスタンスに対して空の geography コレクションを返します。Returns an empty geography collection for an empty geography instance.

初期化されていない geography インスタンスに対して null を返します。Returns null for an uninitialized geography instance.

使用例Examples

A.A. 初期化されていない geography インスタンスに STConvexHull() を使用するUsing STConvexHull() on an uninitialized geography instance

次の例では、初期化されていない geography インスタンスに STConvexHull() を使用します。The following example uses STConvexHull() on an uninitialized geography instance.

 DECLARE @g geography;  
 SELECT @g.STConvexHull();

B.B. 空の geography インスタンスに STConvexHull を使用するUsing STConvexHull on an empty geography instance

次の例では、空の Polygon インスタンスに STConvexHull() を使用します。The following example uses STConvexHull() on an empty Polygon instance.

 DECLARE @g geography = 'POLYGON EMPTY';  
 SELECT @g.STConvexHull().ToString();

C.C. 凸のない Polygon インスタンスの凸包を見つけるFinding the convex hull of a non-convex Polygon instance

次の例では、STConvexHull() を使用して、凸のない Polygon インスタンスの凸包を見つけます。The following example uses STConvexHull() to find the convex hull of a non-convex Polygon instance.

 DECLARE @g geography;  
 SET @g = geography::Parse('POLYGON((-120.533 46.566, -118.283 46.1, -122.3 47.45, -120.533 46.566))');  
 SELECT @g.STConvexHull().ToString();  

D.D. エンベロープの角度が 90 度より大きい geography インスタンスで凸包を見つけるFinding the convex hull on a geography instance with an envelope angle larger than 90 degrees

次の例では、エンベロープの角度が 90 度より大きい geography インスタンスで STConvexHull() を使用します。The following example uses STConvexHull() on a geography instance with an envelope angle larger than 90 degrees.

 DECLARE @g geography = 'POLYGON((20.533 46.566, -18.283 46.1, -22.3 47.45, 20.533 46.566))';  
 SELECT @g.STConvexHull().ToString();