返回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)