ST_GeomFromText
ST_GeomFromText 从输入几何体的已知文本 (WKT) 表示形式构造几何体对象。
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