Lindorm時空函數中的建構函式 - Lindorm

本文介紹時空函數中的建構函式。

引擎與版本

建構函式僅適用於寬表引擎。
寬表引擎為2.6.5及以上版本。如何查看或升級目前的版本，請參見寬表引擎版本說明和升級小版本。

重要

要求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格式中帶有SRID，不支援WKT帶有空間參考系資訊，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) |
+-------------+