適用於：
Databricks SQL Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲，請參閱 SQL 倉儲類型。
傳回輸入 GEOGRAPHY 或 GEOMETRY 值的區域。
Syntax
st_area ( geoExpr )
Arguments
-
geoExpr:GEOGRAPHY或GEOMETRY值。
Returns
類型為 DOUBLE 的值，表示為代表輸入值 GEOGRAPHY 或 GEOMETRY 的區域。
如果輸入是 GEOGRAPHY 值，函式會傳回值的 2D 地理區域 GEOGRAPHY 。
具體而言，函式會傳回多邊形的地理區域，以及多多邊形中多邊形區域的總和。
對於非區域地理位置（點、線字串、多點和多行字串）0 會傳回，而對於幾何集合，函式會傳回集合中元素區域的總和。
結果是藉由假設使用 WGS84 橢球體進行反向大地計算得出的。
結果的單位是平方公尺。
如果輸入是 GEOMETRY 值，函式會傳回值的 2D 笛卡兒區域 GEOMETRY 。
具體而言，函式會傳回多邊形的 2D 笛卡兒區域，以及多多邊形中多邊形區域的總和。
針對非非非幾何（點、線字串、多點和多行字元串）0 會傳回，而對於幾何集合，則會傳回集合中元素區域的總和。
結果的單位是輸入GEOMETRY值的空間參考系統單位的平方。
如果任何輸入為 NULL，則函式會傳NULL回 。
Examples
-- Returns the area of a 2D Cartesian polygon with a hole.
> SELECT st_area(st_geomfromtext('POLYGON((0 0,50 0,50 50,0 50,0 0),(20 20,25 30,30 20,20 20))'));
2450.0