STLineFromText (geometry データ型)

[アーティクル]
12/22/2023

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

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

構文

  
STLineFromText ( 'linestring_tagged_text' , SRID )

Note

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

引数

linestring_tagged_text
返される geometryLineString インスタンスの WKT 表現です。 linestring_tagged_text は nvarchar(max) 式です。

SRID
返される geometryLineString インスタンスの SRID (spatial reference ID) を表す int 式です。

戻り値の型

SQL Server の戻り値の型: geometry

CLR 戻り値の型: SqlGeometry

OGC の型: LineString

注釈

このメソッドでは、入力が整形式でない場合に、FormatException がスローされます。 SQL 仕様バージョン 1.2.1 の Open Geospatial Consortium (OGC) Simple Features の 3 次元ジオメトリと測定ジオメトリの WKT 表記はサポートされていません。 Z (標高) 値と M (メジャー) 値のサポートされている表現の例を参照してください。

例

STLineFromText() を使用して geometry インスタンスを作成する例を次に示します。

例 1:2 次元ジオメトリ WKT

DECLARE @g geometry;  
SET @g = geometry::STLineFromText('LINESTRING (100 100, 200 200)', 0);  
SELECT @g.ToString();

例 2:3 次元ジオメトリ WKT

DECLARE @g geometry;  
SET @g = geometry::STLineFromText('LINESTRING (100 100 100, 200 200 200)', 0);  
SELECT @g.ToString();

例 3: 2 次元測定ジオメトリ WKT

DECLARE @g geometry;  
SET @g = geometry::STLineFromText('LINESTRING (100 100 NULL 100, 200 200 NULL 200)', 0);  
SELECT @g.ToString();

例 4: 3 次元測定ジオメトリ WKT

DECLARE @g geometry;  
SET @g = geometry::STLineFromText('LINESTRING (100 100 100 100, 200 200 200 200)', 0);  
SELECT @g.ToString();

参照

OGC の静的なジオメトリメソッド