与えられたポイントにインタセクトするエッジの識別番号を探索します。

この関数は、トポロジ、ポイント、許容差を引数にして、整数 (エッジの識別番号)を返します。許容差が0の場合、ポイントはエッジとインタセクトしていなければなりません。

ポイントがエッジにインタセクトしない場合には0を返します。

許容差を0より大きくして、ポイント付近のエッジが一つより多い場合には、例外が投げられます。

	許容差が0の場合はST_Intersectsを使い、それ以外ではST_DWinthinを使います。

Availability: 2.0.0 - GEOS 3.3.0以上が必要

例

These examples use edges we created in AddEdge

SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As with1mtol, topology.GetEdgeByPoint('ma_topo',geom,0) As withnotol
FROM ST_GeomFromEWKT('SRID=26986;POINT(227622.6 893843)') As geom;
 with1mtol | withnotol
-----------+-----------
         2 |         0

SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As nearnode
FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;

-- エラー発生 --
ERROR:  Two or more edges found

関連情報

AddEdge, GetNodeByPoint, GetFaceByPoint