Name
|=| — A와 B 사이의 최근접점(closest point of approach)을 잇는 궤도(trajectory)의 거리를 반환합니다.
Synopsis
double precision |=|( geometry A , geometry B );
설명
|=| 연산자는 두 궤도(ST_IsValidTrajectory 참조) 사이의 3차원 거리를 반환합니다. 이 연산자는 ST_DistanceCPA 함수와 동일하지만, 연산자이기 때문에 (PostgreSQL 9.5.0 이상 버전이 필요한) N차원 인덱스를 이용하는 최근접(nearest neightbor) 탐색을 실행하는 데 사용할 수 있습니다.
![[Note]](../images/note.png)
|
|
|
이 피연산자(operand)는 도형에 대해 이용할 수 있을지도 모르는 N차원 GiST 인덱스를 활용할 것입니다. 연산자가 ORDER BY 절 안에 있을 때만 공간 인덱스를 쓴다는 점에서 공간 인덱스를 이용하는 다른 연산자들과는 다릅니다. |
|
|
|
|
도형 가운데 하나가, 예를 들어 a.geom이 아니라 'SRID=3005;LINESTRINGM(0 0 0,0 0 1)'::geometry와 같이, (하위 쿼리/CTE(common table expression) 안에 있지 않은) 상수일 경우에만 인덱스의 효과가 나타납니다. |
2.2.0 버전부터 사용할 수 있습니다. PostgreSQL 9.5 이상 버전에서만 인덱스 지원형(index-supported)을 사용할 수 있습니다.
예시
-- Save a literal query trajectory in a psql variable...
\set qt 'ST_AddMeasure(ST_MakeLine(ST_MakePointM(-350,300,0),ST_MakePointM(-410,490,0)),10,20)'
-- Run the query !
SELECT track_id, dist FROM (
SELECT track_id, ST_DistanceCPA(tr,:qt) dist
FROM trajectories
ORDER BY tr |=| :qt
LIMIT 5
) foo;
track_id dist
----------+-------------------
395 | 0.576496831518066
380 | 5.06797130410151
390 | 7.72262293958322
385 | 9.8004461358071
405 | 10.9534397988433
(5 rows)