カテゴリ：: 地理空間関数

ST_DWITHIN¶

2点（2つの GEOGRAPHY オブジェクト）間の最小大圏距離が、指定された距離内にある場合、 TRUE を返します。それ以外の場合は、 FALSE を返します。

パラメーターが点でない値（線や多角形など） GEOGRAPHY の場合、2つの値のうち最も近い2点間の最小大円距離に基づいて、 TRUE または FALSE を返します。

Tip

検索最適化サービスを使用すると、この関数を呼び出すクエリのパフォーマンスを向上させることができます。詳細については、検索最適化サービスをご参照ください。

構文¶

ST_DWITHIN( <geography_expression_1> , <geography_expression_2> , <distance_in_meters> )

Copy

引数¶

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                                                        |
+-------------------------------------------------------------+

Copy