- カテゴリ:
ST_DWITHIN¶
2点(2つの GEOGRAPHY オブジェクト)間の最小測地線距離が指定された距離内にある場合は、 TRUE を返します。それ以外の場合は、 FALSE を返します。
パラメーターがポイントではない GEOGRAPHY 値の場合(例:線やポリゴン)、2つの値の最も近い2つのポイント間の最小測地線距離に基づいて TRUE または FALSE を返します。
Tip
検索最適化サービスを使用すると、この関数を呼び出すクエリのパフォーマンスを向上させることができます。詳細については、 検索最適化サービス をご参照ください。
構文¶
ST_DWITHIN( <geography_expression_1> , <geography_expression_2> , <distance_in_meters> )
引数¶
geography_expression_1
引数は GEOGRAPHY 型の式でなければなりません。
geography_expression_2
引数は GEOGRAPHY 型の式でなければなりません。
distance_in_meters
引数は REAL 型の式でなければなりません。距離はメートル単位です。
戻り値¶
BOOLEAN を返します。
使用上の注意¶
入力が NULL の場合は NULL を返します。
例¶
赤道に沿って1°離れた2点間のメートル単位の距離が150,000メートル未満であるため、 TRUE を返します。
SELECT ST_DWITHIN (ST_MAKEPOINT(0, 0), ST_MAKEPOINT(1, 0), 150000); +-------------------------------------------------------------+ | ST_DWITHIN (ST_MAKEPOINT(0, 0), ST_MAKEPOINT(1, 0), 150000) | |-------------------------------------------------------------| | True | +-------------------------------------------------------------+