Lindorm 時空間関数におけるコンストラクター関数 - Lindorm

このトピックでは、時空間データ用のコンストラクター関数について説明します。これらの関数を使用して、特定のジオメトリオブジェクトを構築したり、既存の Well-known Text (WKT) 文字列やオブジェクトを他のジオメトリフォーマットに変換したりできます。

エンジンとバージョン

コンストラクター関数は LindormTable にのみ適用されます。
このトピックで説明する集計関数は、LindormTable 2.6.5 以降のバージョンでサポートされています。LindormTable のバージョンを確認またはアップグレードする方法の詳細については、「LindormTable のリリースノート」および「Lindorm インスタンスのマイナーエンジンバージョンのアップグレード」をご参照ください。

重要

Lindorm SQL はバージョン 2.6.8 以降である必要があります。Lindorm SQL のバージョンを確認する方法の詳細については、「SQL バージョン」をご参照ください。

関数

次の表に、Lindorm GanosBase でサポートされているコンストラクター関数を示します。

関数	説明
ST_GeomFromText	指定された WKT 文字列に対応する Geometry オブジェクトを返します。
ST_LineFromMultiPoint	指定された MultiPoint オブジェクトに対応する LineString オブジェクトを返します。
ST_MakePoint	Point オブジェクトを構築します。

ST_GeomFromText

指定された WKT 文字列に対応する Geometry オブジェクトを返します。

構文

geometry ST_GeomFromText(string wkt)

パラメーター

パラメーター	説明
wkt	指定された WKT 文字列。

説明

Geometry オブジェクトは、Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon、GeometryCollection の型をサポートします。
空間参照系の情報を含む WKT 文字列はサポートされていません。WKT フォーマットに空間参照識別子 (SRID) が含まれている場合は、SRID を別の列に格納する必要があります。SRID は識別子としてのみ使用されます。デフォルトの SRID は 4326 です。
任意のデータ型の EMPTY オブジェクトを作成できます。

例

例 1：Geometry オブジェクトが Point の場合。

SELECT ST_GeomFromText('POINT(1 1)') as geom;

次の結果が返されます。

+-------------+
|    geom     |
+-------------+
| POINT (1 1) |
+-------------+

例 2：Geometry オブジェクトが Polygon の場合。

SELECT ST_GeomFromText('POLYGON (( 1 1, 1 2, 2 2, 2 1, 1 1))') AS poly;

次の結果が返されます。

+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|                                                                                                poly                                                                                                |
+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 0020000003000010E600000001000000053FF00000000000003FF00000000000003FF000000000000040000000000000004000000000000000400000000000000040000000000000003FF00000000000003FF00000000000003FF0000000000000 |
+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

例 3：Geometry オブジェクトが EMPTY の場合。

SELECT ST_GeomFromText('POLYGON EMPTY') as geom;

次の結果が返されます。

+---------------+
|     geom      |
+---------------+
| POLYGON EMPTY |
+---------------+

ST_LineFromMultiPoint

指定された MultiPoint オブジェクトに対応する LineString オブジェクトを返します。

構文

geometry ST_LineFromMultiPoint(geometry aMultiPoint)

パラメーター

パラメーター	説明
aMultiPoint	指定された MultiPoint オブジェクト。`ST_Collect` 関数を使用して、Point オブジェクトを MultiPoint オブジェクトに結合できます。

例

SELECT ST_AsText(ST_LineFromMultiPoint(ST_Collect(ST_MakePoint(1,2),ST_MakePoint(3,4),ST_MakePoint(5,6)))) AS astext;

次の結果が返されます。

+-------------------------+
|         astext          |
+-------------------------+
| LINESTRING(1 2,3 4,5 6) |
+-------------------------+

ST_MakePoint

Point オブジェクトを構築します。

構文

geometry ST_MakePoint(double x, double y)

パラメーター

パラメーター	説明
x	経度の値 x。値は DOUBLE 型である必要があります。INTEGER 型または LONG 型の値を入力した場合、自動的に DOUBLE 型に変換されます。
y	緯度の値 y。値は DOUBLE 型である必要があります。INTEGER 型または LONG 型の値を入力した場合、自動的に DOUBLE 型に変換されます。

説明

この関数は、空間参照系の設定や 3D オブジェクトの作成をサポートしていません。

例

SELECT ST_AsText(ST_MakePoint(1, 2)) as text;

次の結果が返されます。

+-------------+
|    text     |
+-------------+
| POINT (1 2) |
+-------------+