Share via


STGeomFromText (geography データ型)

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

インスタンスに格納されている Z (標高) 値および M (メジャー) 値で補完された、Open Geospatial Consortium (OGC) の Well-Known Text (WKT) 表現を基に geography インスタンスを返します。

この 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 入力に対ポッドエッジが含まれている場合に an をスローします。

Note

各点がリストされている順序は、地理ポリゴンにとって重要になります。 それによって、ポリゴン領域が指定されたリングの内側になるか、外側になるかが決まります。 詳細については、「Polygon」をご覧ください。

次の例では、geography インスタンスを作成するために使用STGeomFromText()します。

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();