虚谷文档 v1.0.3

适用虚谷数据库版本

v12.9



适用虚谷数据库版本

v12.9


ST_POLYFROMTEXT ​

📄字数 733
👁️阅读量 加载中...

功能描述 ​

从 OGC 已知的文本表示构造多边形对象。

语法格式 ​

sql
GEOMETRY ST_POLYGONFROMTEXT(CLOB WKT);
GEOMETRY ST_POLYGONFROMTEXT(CLOB WKT, INTEGER srid);

参数说明 ​

  • WKT：已知文本字符串。
  • srid：空间参考系ID。

函数返回类型 ​

GEOGRAPHY 类型

使用说明 ​

  1. 如果未给出 SRID，则默认为 0。
  2. 如果 WKT 多边形表示，则返回 NULL。
  3. 如果绝对确定所有 WKT 都是多边形，请不要使用此函数。 它比 ST_GEOMFROMTEXT 慢，因为它添加了额外的验证步骤。
  4. 此方法实现了 SQL 1.1 的 OGC 简单功能规范。 s3.2.6.2
  5. 该方法实现了SQL/MM规范。SQL-MM 3: 7.2.8

示例 ​

sql
SQL>  SELECT TO_CHAR(ST_ASTEXT(ST_POLYGONFROMTEXT('POLYGON((-71.1776585052917 42.3902909739571,-71.1776820268866 42.3903701743239,
          -71.1776063012595 42.3903825660754,-71.1775826583081 42.3903033653531,-71.1776585052917 42.3902909739571))')));

+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|                                                                                           EXPR1                                                                                           |
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| POLYGON((-71.1776585052917 42.3902909739571,-71.1776820268866 42.3903701743239,-71.1776063012595 42.3903825660754,-71.1775826583081 42.3903033653531,-71.1776585052917 42.3902909739571)) |
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+


SQL> SELECT ST_POLYGONFROMTEXT('POINT(1 2)') as point_is_notpoly;

+------------------+
| POINT_IS_NOTPOLY |
+------------------+
| <NULL>           |
+------------------+