ST_GeomFromText - Amazon Redshift

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

ST_GeomFromText

ST_GeomFromText 會從輸入幾何的已知文字 (WKT) 表示法建構幾何物件。

地理文本接受 3DZ、3DM 和 4D,其中幾何類型分別以 Z、M 或 ZM 為前綴。

Syntax (語法)

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_stringsrid 為 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