ST_GeomFromText
将熟知文本 (WKT) 字符串转换为其对应的 GEOMETRY 对象。使用此函数可将 WKT 字符串转换为 Vertica Place 函数所需的格式。
GEOMETRY 对象是按平面坐标定义的空间对象。坐标表示为笛卡尔平面上的点 (x,y)。SRID 值为 0 至 232-1 是有效的。超出此范围的 SRID 值将会生成错误。
GEOMETRY 对象的最大大小为 10 MB。如果将 WKT 传递给 ST_GeomFromText 并且生成大小超过 10 MB 的空间对象，ST_GeomFromText 将会返回错误。
开放地理空间联盟 (OGC) 定义了 WKT 表示的格式。请参见 简易功能访问第 1 部分 - 通用架构规范第 7 节。
行为类型
不可变语法
ST_GeomFromText( wkt [, srid] [ USING PARAMETERS ignore_errors={'y'|'n'} ])
参数
wkt- GEOMETRY 对象的熟知文本 (WKT) 字符串，类型为 LONG VARCHAR。
srid- （不执行操作时可选）
GEOMETRY 对象的空间参照系标识符 (SRID)，类型为 INTEGER。
SRID 将存储在 GEOMETRY 对象中，但不影响空间计算的结果。
ignore_errors- （可选）ST_GeomFromText 将基于提供的参数返回以下结果：
-
NULL—如果
wkt无效并且ignore_errors='y'。 -
Error—如果
wkt无效并且ignore_errors='n'或未指定。
-
返回
GEOMETRY
支持的数据类型
- 数据类型
- GEOMETRY
- Point
- 是
- Multipoint
- 是
- Linestring
- 是
- Multilinestring
- 是
- Polygon
- 是
- Multipolygon
- 是
- GeometryCollection
- 否
示例
以下示例显示了 ST_GeomFromText 的用法。
将 WKT 转换为 GEOMETRY 对象：
=> SELECT ST_Area(ST_GeomFromText('POLYGON((1 1,2 3,3 5,0 5,1 -2,0 0,1 1))'));
ST_Area
---------
6
(1 row)