ST_DWITHIN

📄字数 695

👁️阅读量 加载中...

功能描述

如果几何图形在给定距离内，则返回 TRUE。

语法格式

BOOLEAN ST_DWITHIN(GEOMETRY geomA, GEOMETRY geomB, DOUBLE distance_of_srid);
BOOLEAN ST_DWITHIN(GEOGRAPHY geogA, GEOGRAPHY geogB, DOUBLE distance_meters, BOOLEAN use_spheroid = TRUE);
BOOLEAN ST_DWITHIN(CLOB geomA, CLOB geomB, DOUBLE distance_of_srid);

参数说明

• geomA：第一个目标 GEOMETRY 对象。
• geomB：第二个目标 GEOMETRY 对象。
• geogA：第一个目标 GEOGRAPHY 对象。
• geogB：第二个目标 GEOGRAPHY 对象。
• distance_of_srid：指定距离，以几何空间参考系统定义的单位指定。
• distance_meters:指定距离，单位为米。
• use_spheroid：距离测量是否使用椭球体，可选。
  • TRUE：使用椭球体。
  • FALSE：在球面上进行测量，计算更快。

函数返回类型

BOOLEAN 类型

使用说明

1. 源几何图形必须具有相同的坐标投影，并具有相同的 SRID。
2. 将 ST_3DDWITHIN 用于 3D 几何图形。
3. 此功能自动包括利用几何上可用的任何空间索引的边界框比较。

示例

与 ST_DFULLYWITHIN 对比：

SQL> SELECT
     ST_DFULLYWITHIN(g1,g2,2),
     ST_DWITHIN(g1,g2,2)
     FROM (
         SELECT 'LINESTRING(0 1,1 1)'::GEOMETRY as g1,
          'LINESTRING(0 0,0 -1)'::GEOMETRY as g2) as test;

+-------+-------+
| EXPR1 | EXPR2 |
+-------+-------+
| F     | T     |
+-------+-------+

(1 row)