ST_GeomFromText - Amazon Redshift
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

ST_GeomFromText

ST_GeomFromText 从输入几何体的已知文本 (WKT) 表示形式构造几何体对象。

ST_GeomFromText 接受 3DZ、3DM 和 4D,其中几何类型分别以 Z、M 或 ZM 作为前缀。

Syntax

ST_GeomFromText(wkt_string)
ST_GeomFromText(wkt_string, srid)

Arguments

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 无效,则返回一个错误。

Examples

以下 SQL 从 WKT 表示形式和 SRID 值构造几何体对象。

SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);
st_geomfromtext -------------------------------- 0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000