返回Geometry1上最接近Geometry2的三维点。此点也是Geometry1和Geometry2之间最短直线的第一个点。

语法

geometry  ST_3DClosestPoint(geometry  g1 , geometry  g2);

参数

参数名称 描述
g1 第一个Geometry对象。
g2 第二个Geometry对象。

描述

  • 该函数支持3D对象,并且不会删除Z坐标。

    针对3D对象,最短距离是基于三维计算的。

  • 该函数支持Polyhedral Surface类型对象。
  • 如果输入的是2D对象,返回的也将是不带Z值的2D对象。

示例

默认调用:
SELECT ST_AsText(ST_3DClosestPoint('LINESTRING(0 0 0,1 1 1)'::geometry,'LINESTRING(0 0 1,1 1 0)'::geometry));
       st_astext
-----------------------
 POINT Z (0.5 0.5 0.5)
(1 row)