STGeomFromText (geography データ型)
適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance
インスタンスに格納されている Z (標高) 値および M (メジャー) 値で補完された、Open Geospatial Consortium (OGC) の Well-Known Text (WKT) 表現を基に geography インスタンスを返します。
この 地理 データ型メソッドは、半球より大きい FullGlobe
インスタンスまたは空間インスタンスをサポートします。
構文
STGeomFromText ( 'geography_tagged_text' , SRID )
Note
SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。
引数
geography_tagged_text
返される geography インスタンスの WKT 表現。 geography_tagged_text は nvarchar(max)です。
SRID
返す geography インスタンスの空間参照 ID (SRID) を表すint式。
戻り値の型
- SQL Server 戻り値の型: geography
- CLR 戻り値の型:
SqlGeography
解説
STGeomFromText()
によって返された geography インスタンスの OGC 型は、対応する WKT 入力に設定されます。
このメソッドは、入力に対ポッドエッジが含まれている場合に ArgumentException
をスローします。
Note
各点がリストされている順序は、地理ポリゴンにとって重要になります。 それによって、ポリゴン領域が指定されたリングの内側になるか、外側になるかが決まります。 詳細については、「Polygon」をご覧ください。
例
次の例では、 STGeomFromText()
を使用して geography インスタンスを作成します。
DECLARE @g geography;
-- Starting point: Lat. 47.656, Lon. -122.360
-- Ending point: Lat. 47.656, Lon. -122.343
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);
SELECT @g.ToString();