

 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\$1LengthSphere
<a name="ST_LengthSphere-function"></a>

ST\$1LengthSphere 會傳回線性幾何的長度 (以公尺為單位)。對於點、多點幾何和面積幾何，ST\$1LengthSphere 會傳回 0。對於幾何集合，ST\$1LengthSphere 會傳回集合中線性幾何的總長度 (以公尺為單位)。

ST\$1LengthSphere 會將輸入幾何的每個點的座標解釋為經度和緯度 (以度為單位)。對於 3DZ、3DM 或 4D 幾何，僅使用前兩個座標。

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

```
ST_LengthSphere(geom)
```

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

 *geom*   
`GEOMETRY` 資料類型的值，或是評估為 `GEOMETRY` 類型的表達式。

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

`DOUBLE PRECISION` 長度的單位是公尺。長度計算是根據地球的球形模型，其半徑是世界大地測量系統 (WGS) 84 地球橢球模型的地球平均半徑。

如果 *geom* 為 Null，則會傳回 Null。

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

下列範例 SQL 會計算 linestring 長度 (以公尺為單位)。

```
SELECT ST_LengthSphere(ST_GeomFromText('LINESTRING(10 10,45 45)'));
```

```
 st_lengthsphere  
------------------
 5127736.08292556
```