引数が NULL の場合、またはジオメトリ引数が空のジオメトリの場合、戻り値は NULL です。

ジオメトリ引数が構文的に整形式のジオメトリでない場合は、ER_GIS_INVALID_DATA エラーが発生します。

未定義の空間参照システム (SRS) でジオメトリ引数が構文的に整形式のジオメトリである場合、ER_SRS_NOT_FOUND エラーが発生します。

複数のジオメトリ引数を取る関数では、それらの引数が同じ SRS 内にない場合、ER_GIS_DIFFERENT_SRIDS エラーが発生します。

ジオメトリ学的に無効なジオメトリ引数がある場合は、結果が true または false (どちらでも定義されていない) か、エラーが発生します。

地理 SRS ジオメトリ引数で、範囲外の経度または緯度を持つ引数がある場合、エラーが発生します:

表示される範囲は度数です。 SRS で別の単位が使用されている場合、範囲ではその単位に対応する値が使用されます。 浮動小数点演算のため、正確な範囲制限はわずかに偏差します。

それ以外の場合、戻り値は NULL 以外です。

ユニットは、INFORMATION_SCHEMA ST_UNITS_OF_MEASURE テーブルで見つかった場合にサポートされます。 セクション26.37「INFORMATION_SCHEMA ST_UNITS_OF_MEASURE テーブル」を参照してください。

ユニットが指定されているが、MySQL でサポートされていない場合は、ER_UNIT_NOT_FOUND エラーが発生します。

サポートされている線形単位が指定され、SRID が 0 の場合、ER_GEOMETRY_IN_UNKNOWN_LENGTH_UNIT エラーが発生します。

サポートされている線形単位が指定され、SRID が 0 でない場合、結果はその単位になります。

単位が指定されていない場合、結果はデカルトか地理的かにかかわらず、ジオメトリの SRS の単位になります。 現在、すべての MySQL SRS はメーターで表されます。

ST_Contains(g1, g2)

g1 が g2 を完全に含んでいるかどうかを示す 1 または 0 を返します。 これは、ST_Within() とは逆の関係をテストします。

ST_Contains() は、このセクションの概要で説明されているように引数を処理します。

ST_Crosses(g1, g2)

空間リレーションに次のプロパティがある場合、2 つのジオメトリが空間的に交差になります:

この関数は、g1 が g2 を空間的に横断するかどうかを示す 1 または 0 を戻します。

ST_Crosses() は、次の追加条件で戻り値が NULL であることを除き、このセクションの概要で説明されているように引数を処理します:

ST_Disjoint(g1, g2)

g1 が g2 と空間的に切り離されている (交差していない) かどうかを示す 1 または 0 を返します。

ST_Disjoint() は、このセクションの概要で説明されているように引数を処理します。

ST_Distance(g1, g2 [, unit])

g1 と g2 の間の距離を戻します。ジオメトリ引数の空間参照システム (SRS) の長さ単位で測定されるか、オプションの unit 引数 (指定されている場合) の単位で測定されます。

この関数は、2 つのジオメトリ引数のコンポーネントのすべての組合せ間の最短距離を戻すことで、ジオメトリコレクションを処理します。

ST_Distance() は、このセクションの概要で説明されているようにジオメトリ引数を処理しますが、次の例外があります:

MySQL 8.0.14 以降、ST_Distance() では、戻される距離値の線形単位を指定するオプションの unit 引数が許可されます。 ST_Distance() は、このセクションの概要で説明されているように、その unit 引数を処理します。

mysql> SET @g1 = ST_GeomFromText('POINT(1 1)');
mysql> SET @g2 = ST_GeomFromText('POINT(2 2)');
mysql> SELECT ST_Distance(@g1, @g2);
+-----------------------+
| ST_Distance(@g1, @g2) |
+-----------------------+
|    1.4142135623730951 |
+-----------------------+

mysql> SET @g1 = ST_GeomFromText('POINT(1 1)', 4326);
mysql> SET @g2 = ST_GeomFromText('POINT(2 2)', 4326);
mysql> SELECT ST_Distance(@g1, @g2);
+-----------------------+
| ST_Distance(@g1, @g2) |
+-----------------------+
|     156874.3859490455 |
+-----------------------+
mysql> SELECT ST_Distance(@g1, @g2, 'metre');
+--------------------------------+
| ST_Distance(@g1, @g2, 'metre') |
+--------------------------------+
|              156874.3859490455 |
+--------------------------------+
mysql> SELECT ST_Distance(@g1, @g2, 'foot');
+-------------------------------+
| ST_Distance(@g1, @g2, 'foot') |
+-------------------------------+
|             514679.7439273146 |
+-------------------------------+

球の距離計算の特殊なケースについては、ST_Distance_Sphere() 関数を参照してください。

ST_Equals(g1, g2)

g1 が g2 と空間的に等しいかどうかを示す 1 または 0 を返します。

ST_Equals() は、空のジオメトリ引数に対して NULL を返さない点を除き、このセクションの概要で説明されているように引数を処理します。

mysql> SET @g1 = Point(1,1), @g2 = Point(2,2);
mysql> SELECT ST_Equals(@g1, @g1), ST_Equals(@g1, @g2);
+---------------------+---------------------+
| ST_Equals(@g1, @g1) | ST_Equals(@g1, @g2) |
+---------------------+---------------------+
|                   1 |                   0 |
+---------------------+---------------------+

ST_FrechetDistance(g1, g2 [, unit])

ジオメトリがどの程度類似しているかを反映して、2 つのジオメトリ間の離散フレシェ距離を返します。 結果は、ジオメトリ引数の空間参照システム (SRS) の長さ単位、または引数が指定されている場合は unit 引数の長さ単位で測定された倍精度の数値です。

この関数は、離散フレシェ距離を実装します。つまり、ジオメトリの点間の距離に制限されます。 たとえば、2 つの LineString 引数がある場合、ジオメトリに明示的に記述された点のみが考慮されます。 これらの点の間の線分セグメント上の点は考慮されません。

ST_FrechetDistance() は、このセクションの概要で説明されているようにジオメトリ引数を処理しますが、次の例外があります:

ST_FrechetDistance() は、このセクションの概要で説明されているように、オプションの unit 引数を処理します。

mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)');
mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)');
mysql> SELECT ST_FrechetDistance(@ls1, @ls2);
+--------------------------------+
| ST_FrechetDistance(@ls1, @ls2) |
+--------------------------------+
|             2.8284271247461903 |
+--------------------------------+

mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)', 4326);
mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)', 4326);
mysql> SELECT ST_FrechetDistance(@ls1, @ls2);
+--------------------------------+
| ST_FrechetDistance(@ls1, @ls2) |
+--------------------------------+
|              313421.1999416798 |
+--------------------------------+
mysql> SELECT ST_FrechetDistance(@ls1, @ls2, 'foot');
+----------------------------------------+
| ST_FrechetDistance(@ls1, @ls2, 'foot') |
+----------------------------------------+
|                     1028284.7767115477 |
+----------------------------------------+

この関数は、MySQL 8.0.23 で追加されました。

ST_HausdorffDistance(g1, g2 [, unit])

ジオメトリがどの程度類似しているかを反映して、2 つのジオメトリ間の離散ハスドルフ距離を返します。 結果は、ジオメトリ引数の空間参照システム (SRS) の長さ単位、または引数が指定されている場合は unit 引数の長さ単位で測定された倍精度の数値です。

この関数は、離散ハスドルフ距離を実装します。つまり、ジオメトリの点間の距離に制限されます。 たとえば、2 つの LineString 引数がある場合、ジオメトリに明示的に記述された点のみが考慮されます。 これらの点の間の線分セグメント上の点は考慮されません。

ST_HausdorffDistance() は、このセクションの概要で説明されているようにジオメトリ引数を処理しますが、次の例外があります:

ST_HausdorffDistance() は、このセクションの概要で説明されているように、オプションの unit 引数を処理します。

mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)');
mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)');
mysql> SELECT ST_HausdorffDistance(@ls1, @ls2);
+----------------------------------+
| ST_HausdorffDistance(@ls1, @ls2) |
+----------------------------------+
|                                1 |
+----------------------------------+

mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)', 4326);
mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)', 4326);
mysql> SELECT ST_HausdorffDistance(@ls1, @ls2);
+----------------------------------+
| ST_HausdorffDistance(@ls1, @ls2) |
+----------------------------------+
|               111319.49079326246 |
+----------------------------------+
mysql> SELECT ST_HausdorffDistance(@ls1, @ls2, 'foot');
+------------------------------------------+
| ST_HausdorffDistance(@ls1, @ls2, 'foot') |
+------------------------------------------+
|                        365221.4264870815 |
+------------------------------------------+

この関数は、MySQL 8.0.23 で追加されました。

ST_Intersects(g1, g2)

g1 が g2 と空間的に交差しているかどうかを示す 1 または 0 を返します。

ST_Intersects() は、このセクションの概要で説明されているように引数を処理します。

ST_Overlaps(g1, g2)

2 つのジオメトリが交差し、その交差によって同じディメンションのジオメトリが生成され、指定されたジオメトリのいずれとも等しくない場合、これらのジオメトリは空間的にオーバーラップになります。

この関数は、g1 が g2 と空間的にオーバーラップするかどうかを示す 1 または 0 を戻します。

ST_Overlaps() は、このセクションの概要で説明されているように引数を処理します。ただし、戻り値は、2 つのジオメトリのディメンションが等しくないという追加条件では NULL です。

ST_Touches(g1, g2)

内部が交差しないが、いずれかのジオメトリの境界が他のジオメトリの境界または内部と交差する場合、2 つのジオメトリは空間的なタッチです。

この関数は、g1 が g2 に空間的に接触するかどうかを示す 1 または 0 を戻します。

ST_Touches() では、両方のジオメトリのディメンションが 0 (Point または MultiPoint) である追加条件の戻り値が NULL であることを除き、このセクションの概要で説明するように引数が処理されます。

ST_Within(g1, g2)

g1 が空間的に g2 の内部にあるかどうかを示す 1 または 0 を返します。 これは、ST_Contains() とは逆の関係をテストします。

ST_Within() は、このセクションの概要で説明されているように引数を処理します。