ST_Distance

ST_Distem 會傳回兩個輸入幾何值的 2D 投影間的最小歐幾裏得距離。

ST_Distem 會在 3DM、3DZ、4D 幾何中傳回兩個輸入幾何值的 2D 投影間的歐幾裏得距離。

對於輸入地理位置，ST_Dimende 返回兩個 2D 點的測地線距離。距離單位以米為單位。對於點和空點以外的地理位置，將返回錯誤。

Syntax (語法)

ST_Distance(geo1, geo2)

引數

地理 1

資料類型的值GEOMETRY或者GEOGRAPHY，或判斷值為GEOMETRY或者GEOGRAPHY。的資料類型地理 1必須與地理 2。

地理 2

資料類型的值GEOMETRY或者GEOGRAPHY，或判斷值為GEOMETRY或者GEOGRAPHY。的資料類型地理 2必須與地理 1。

傳回類型

DOUBLE PRECISION與輸入幾何或地理位置相同單位的。

如果地理 1或者地理 2為 Null 或 Null，則會傳回 Null。

如果地理 1和地理 2空間參考系統識別符 (SRID) 不同，則會傳回錯誤。

如果地理 1或者地理 2是幾何集合，則會傳回錯誤。

範例

以下 SQL 會傳回兩個多邊形之間的距離。

SELECT ST_Distance(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 -3,-2 -1,0 -3,-1 -3))'));

  st_distance
-----------
1.4142135623731               

以下 SQL 會傳回地理位置中兩點之間的距離。

SELECT ST_Distance(ST_GeogFromText('point(1 1)'),ST_GeogFromText('point( -21.32 121.2)'));

   st_distance
------------------
 13090291.8796529