Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# ST\$1Area
<a name="ST_Area-function"></a>

對於輸入幾何，ST\$1Area 傳回 2D 投影的笛卡爾面積。面積單位與表示輸入幾何座標的單位相同。對於點、linestring、multipoint 和 multilinestring，函數會傳回 0。對於幾何集合，它會傳回集合中幾何面積的總和。

對於輸入地理，ST\$1Area 會傳回在球體 (由 SRID 決定) 上所計算輸入面積地理之 2D 投影的測地線面積。長度單位為平方公尺。對於點、multipoint 和線形地理，此函數會傳回零 (0)。當輸入為幾何集合時，此函數會傳回集合中面積地理的面積總和。

## 語法
<a name="ST_Area-function-syntax"></a>

```
ST_Area(geo)
```

## 引數
<a name="ST_Area-function-arguments"></a>

 *geo*   
`GEOMETRY` 或 `GEOGRAPHY` 資料類型的值，或是評估為 `GEOMETRY` 或 `GEOGRAPHY` 類型的運算式。

## 傳回類型
<a name="ST_Area-function-return"></a>

`DOUBLE PRECISION`

如果 *geo* 為 null，則傳回 null。

## 範例
<a name="ST_Area-function-examples"></a>

下列 SQL 會傳回 multipolygon 的笛卡爾面積。

```
SELECT ST_Area(ST_GeomFromText('MULTIPOLYGON(((0 0,10 0,0 10,0 0)),((10 0,20 0,20 10,10 0)))'));
```

```
 st_area
---------
     100
```

以下 SQL 傳回地理中多邊形的面積。

```
SELECT ST_Area(ST_GeogFromText('polygon((34 35, 28 30, 25 34, 34 35))'));
```

```
     st_area
------------------
 201824655743.383
```

下列 SQL 針對線性地理傳回零。

```
SELECT ST_Area(ST_GeogFromText('multipoint(0 0, 1 1, -21.32 121.2)'));
```

```
 st_area
---------
       0
```