Name

GetFaceByPoint — 与えたポイントとインタセクトするフェイスを見つけます。

Synopsis

integer GetFaceByPoint(varchar atopology, geometry apoint, float8 tol1);

説明

ポイントと与えた許容値で参照されるフェイスを見つけます。

この関数は、ポイントを中心に持ち半径が許容値となる円とインタセクトするフェイスを効率的に探します。

与えられたクエリ位置とインタセクトするフェイスが無い場合には、0を返します (ユニバーサルフェイス)。

1以上のフェイスがクエリ位置とインタセクトする場合には例外が投げられます。

Availability: 2.0.0

Enhanced: 3.2.0 より効率的な実装とより明確な短縮、不正なトポロジでの動作停止。

SELECT topology.GetFaceByPoint('ma_topo',geom, 10) As with1mtol, topology.GetFaceByPoint('ma_topo',geom,0) As withnotol
        FROM ST_GeomFromEWKT('POINT(234604.6 899382.0)') As geom;

         with1mtol | withnotol
        -----------+-----------
                         1 |         0
SELECT topology.GetFaceByPoint('ma_topo',geom, 1) As nearnode
        FROM ST_GeomFromEWKT('POINT(227591.9 893900.4)') As geom;

-- get error --
ERROR:  Two or more faces found