ST_ GeomFromText

ST_ 從輸入幾何圖形的已知文字 (WKT) 表現法GeomFromText 建構幾何圖形物件。

ST_ GeomFromText 接受 3DZ、3DM 和 4D，其中幾何類型分別以 Z、M 或 ZM 作為前綴。

語法

ST_GeomFromText(wkt_string)

ST_GeomFromText(wkt_string, srid)

引數

wkt_string

VARCHAR 資料類型的值，其為幾何的 WKT 表示法。

您可以使用 WKT 關鍵字 EMPTY 來指定空點、具有空點的多點或具有空點的幾何集合。下列範例使用一個空點和一個非空點建立多點。

ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');

srid

INTEGER 資料類型的值，其為空間參考識別碼 (SRID)。如果有提供 SRID 值，則傳回的幾何便會包含此 SRID 值。否則，傳回幾何的 SRID 值會設為零 (0)。

傳回類型

GEOMETRY

如果 wkt_string 或 srid 為 Null，則會傳回 Null。

如果 srid 為負值，則會傳回 Null。

如果 wkt_string 無效，則會傳回錯誤。

如果 srid 無效，則會傳回錯誤。

範例

以下 SQL 會從 WKT 表示法和 SRID 值建構幾何物件。

SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);

st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000