ST_DISTANCE

Description

2つのgeometryオブジェクト間の球面上の最短距離をメートルで計算します。この関数は計算に球面地球モデルを使用します。

経度と緯度の座標を受け取るST_DISTANCE_SPHEREとは異なり、ST_DISTANCEはgeometryオブジェクト（点、線、ポリゴン、円など）をパラメータとして受け取り、それらの境界間の最短距離を計算します。2つの形状が交差する場合（接触や包含を含む）、0を返します。

Note

Apache Doris 4.0.4以降でサポート

Syntax

ST_DISTANCE( <shape1>, <shape2> )

Parameters

Parameter	Description
<shape1>	最初のジオメトリ。Point、Line、Polygon、Circle、MultiPolygonをサポートします。
<shape2>	2番目のジオメトリ。Point、Line、Polygon、Circle、MultiPolygonをサポートします。

Return Value

2つのジオメトリオブジェクトの境界間の最短球面距離をメートル単位（DOUBLE型）で返します。

ST_DISTANCEには以下のエッジケースがあります：

• 入力パラメータがNULLの場合、NULLを返します。
• 入力パラメータが有効なジオメトリオブジェクトとして解析できない場合、NULLを返します。
• 2つのジオメトリオブジェクトが交差している場合（一方が他方を含んでいる場合を含む）、0.0を返します。
• サポートされるジオメトリタイプには以下が含まれます：POINT、LINESTRING、POLYGON、CIRCLE、MULTIPOLYGON。

Example

ポイント間の距離

-- Calculate the distance between two points with a 1-degree longitude difference on the equator
SELECT ST_DISTANCE(ST_GeometryFromText('POINT(0 0)'), ST_GeometryFromText('POINT(1 0)'));

+---------------------------------------------+
| ST_Distance(ST_Point(0, 0), ST_Point(1, 0)) |
+---------------------------------------------+
|                           111195.1011774839 |
+---------------------------------------------+

点と直線の間の距離

-- Calculate the shortest distance from a point to a line
SELECT ST_DISTANCE(ST_GeometryFromText('POINT(2 2)'), ST_GeometryFromText('LINESTRING(0 0, 10 0)'));

+----------------------------------------------------------------------------------------------+
| ST_DISTANCE(ST_GeometryFromText('POINT(2 2)'), ST_GeometryFromText('LINESTRING(0 0, 10 0)')) |
+----------------------------------------------------------------------------------------------+
|                                                                            222390.2023549678 |
+----------------------------------------------------------------------------------------------+

ポリゴンと円の交差 (距離 0)

-- Circle intersects polygon; the center is outside but the circle covers part of the polygon's boundary
SELECT ST_DISTANCE(
    ST_GeometryFromText('POLYGON ((-0.00045 -0.00045, 0.00045 -0.00045, 0.00045 0.00045, -0.00045 0.00045, -0.00045 -0.00045))'),
    ST_Circle(0.0006, 0, 50)
);

+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ST_DISTANCE(
    ST_GeometryFromText('POLYGON ((-0.00045 -0.00045, 0.00045 -0.00045, 0.00045 0.00045, -0.00045 0.00045, -0.00045 -0.00045))'),
    ST_Circle(0.0006, 0, 50)
) |
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|                                                                                                                                                                             0 |
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

無効なパラメータ（NULLを返す）

-- Invalid WKT string
SELECT ST_DISTANCE(ST_GeometryFromText('NOT_A_GEOMETRY'), ST_GeometryFromText('POINT(1 1)'));

+---------------------------------------------------------------------------------------+
| ST_DISTANCE(ST_GeometryFromText('NOT_A_GEOMETRY'), ST_GeometryFromText('POINT(1 1)')) |
+---------------------------------------------------------------------------------------+
|                                                                                  NULL |
+---------------------------------------------------------------------------------------+

NULLパラメータ

SELECT ST_DISTANCE(NULL, ST_GeometryFromText('POINT(1 1)'));

+------------------------------------------------------+
| ST_DISTANCE(NULL, ST_GeometryFromText('POINT(1 1)')) |
+------------------------------------------------------+
|                                                 NULL |
+------------------------------------------------------+