指定されたタイムウィンドウ内で、軌道オブジェクト 1 上の点のうち、軌道オブジェクト 2 に幾何学的に最も近い位置にある点を返します。戻り値は、最接近時点における `traj1` の空間位置を表す geometry 値です。
構文
geometry ST_nearestApproachPoint(trajectory traj1, trajectory traj2)
geometry ST_nearestApproachPoint(trajectory traj1, trajectory traj2, tsrange range)
geometry ST_nearestApproachPoint(trajectory traj1, trajectory traj2, timestamp t1, timestamp t2)2 番目および 3 番目のオーバーロードでは、評価対象を `tsrange` 値、または明示的な `timestamp` 境界で指定したタイムウィンドウに制限します。
パラメーター
| パラメーター | 説明 |
|---|---|
traj1 | ソース軌道です。返される点は、この軌道上に存在します。 |
traj2 | 距離を測定する対象となるリファレンス軌道です。 |
t1 | タイムウィンドウの開始時刻です。 |
t2 | タイムウィンドウの終了時刻です。 |
range | タイムウィンドウを `tsrange` 値として指定します。 |
例
次のクエリは、2010 年 1 月 1 日の 13:00 から 14:00 の間において、軌道 1 上で軌道 2 に最も近い位置にあった点を取得します。
SELECT ST_nearestApproachPoint(
(SELECT traj FROM traj_table WHERE id = 1),
(SELECT traj FROM traj_table WHERE id = 2),
'2010-1-1 13:00:00',
'2010-1-1 14:00:00'
);このクエリは、指定されたタイムウィンドウ内で軌道 2 に最接近した瞬間における軌道 1 の位置を表す `geometry` ポイントを返します。