ST_VoronoiPolygons

更新時間:
Copy as MD

根據提供的Geometry對象的頂點計算二維Voronoi圖。

文法

geometry  ST_VoronoiPolygons(geometry  g1, float  tolerance, geometry  extend_to);

參數

參數名稱描述
g1目標Geometry對象。
tolerance容差,預設為0.0。若兩點間距小於該值,則視為重合點。通過提供非零容差距離可以提高演算法的魯棒性。
extend_to擴充圖形,預設為null,代表以輸入幾何的邊界框在每個方向上擴充了約50%作為擴充圖形。如果設定了該值,Voronoi圖將擴充到覆蓋該值的外包框的範圍,除非提供擴充圖形的外包框小於預設值。

描述

  • 結果是PolygonGeometryCollection對象,外包框大於輸入對象的頂點的外包範圍。
  • 如果輸入幾何為null,則返回null。
  • 如果輸入幾何只包含一個頂點,則返回一個空的GeometryCollection對象。如果輸入幾何只包含一個頂點,則返回一個空的GeometryCollection對象。
  • 如果extend_to值的外包框面積為零,則返回一個空的GeometryCollection對象。

樣本

設定extend_to參數效果對比:
SELECT ST_VoronoiPolygons(g,0,e),g,e
             from (select ST_Buffer('LINESTRING(0 0,3 0,3 3)'::geometry,1,'join=mitre endcap=square') as g,
                    ST_Buffer('POINT(-1 -1)'::geometry,10) as e) as t;
12