虚谷文档 v1.0.3

适用虚谷数据库版本

v12.9



适用虚谷数据库版本

v12.9


ST_MINIMUMCLEARANCE ​

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

功能描述 ​

返回两个几何图形之间的 3D 最大笛卡尔距离，以投影单位（空间参考单位）表示。

语法格式 ​

sql
DOUBLE ST_MINIMUMCLEARANCE(GEOMETRY g);

参数说明 ​

  • g：目标 GEOMETRY 对象。

函数返回类型 ​

DOUBLE 类型

使用说明 ​

  1. 几何图形有可能满足 ST_IsValid（多边形）或 ST_IsSimple（线）的有效性标准，但如果其顶点之一是无效的，则该几何图形将变得无效。
  2. 几何图形将变得无效的原因，可能是转换为文本格式（例如 WKT、KML、GML、GeoJSON）或不使用双精度浮点坐标的二进制格式（例如 MapInfo TAB）期间的精度损失。
  3. 最小间隙是几何形状对坐标精度变化的稳健性的定量测量。 它是在不创建无效几何体的情况下可以移动几何体顶点的最大距离。
  4. 最小间隙值越大，表明稳健性越好。
  5. 如果几何形状的最小间隙为 e，则：
  • 几何中没有两个不同的顶点比距离e更近。
  • 没有顶点比 e 更接近它不是端点的线段。
  1. 如果几何体不存在最小间隙（例如，单个点或点相同的多点），则返回值为 Infinity。
  2. 为了避免精度损失导致的有效性问题，ST_ReducePrecision 可以降低坐标精度，同时确保多边形几何保持有效。

示例 ​

sql
SQL> SELECT ST_MinimumClearance('POLYGON ((0 0, 1 0, 1 1, 0.5 3.2e-4, 0 0))');

+--------------+
|    EXPR1     |
+--------------+
| 3.200000e-04 |
+--------------+

(1 row)